Endpointuri
Publică o aplicație
Pune online aplicația salvată, la fel ca butonul Publish.
https://www.setherion.com/api/v1/projects/{id}/publishPlan: Orice plan
Pune aplicația online exact așa cum este salvată, prin aceiași pași ca butonul Publish din editor. O aplicație care a fost publicată înainte își păstrează adresa, iar una publicată pentru prima oară primește o adresă făcută din numele ei, pe setherion.app.
Publicarea nu consumă credite. Trebuie să poți modifica aplicația. Prin API sunt permise cel mult 100 de publicări pe cont pe zi, o limită pe care nimeni care lucrează de mână n-o atinge; butonul din editor nu are o asemenea limită.
Cererea
Nu e nevoie de niciun corp.
curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/publish \
-H "Authorization: Bearer $SETHERION_API_KEY"Răspunsul
{ "ok": true, "url": "https://coffee-shop.setherion.app", "ready": true }| Câmp | Tip | Ce înseamnă |
|---|---|---|
ok | boolean | true când aplicația a fost publicată. |
url | string | Unde este aplicația online. |
ready | boolean | false când adresa încă se pregătește. Funcționează în cel mult un minut sau două. |
Poți publica de două ori aceeași aplicație salvată fără grijă: al doilea apel răspunde cu aceeași adresă.
Modifici, apoi publici
Ce se publică este ce e salvat, iar o modificare se salvează când se termină. Așa că o modificare urmată de o publicare pune schimbarea online:
const base = 'https://www.setherion.com/api/v1/projects'
const headers = {
Authorization: `Bearer ${process.env.SETHERION_API_KEY}`,
'Content-Type': 'application/json',
}
const edit = await fetch(`${base}/${appId}/edit`, {
method: 'POST',
headers,
body: JSON.stringify({ prompt: 'Add a contact form' }),
}).then(r => r.json())
if (edit.ok) {
const live = await fetch(`${base}/${appId}/publish`, { method: 'POST', headers }).then(r => r.json())
console.log(live.url)
}Erori
| Status | Când |
|---|---|
400 | Codul aplicației conține un secret, de pildă o cheie API, și nu a fost publicat. Eroarea spune unde. |
401 | Cheia lipsește, e greșită sau a fost revocată. |
404 | Nu există o asemenea aplicație sau cheia ta nu o poate modifica. |
409 | Aplicația nu are încă cod, sau adresa de care are nevoie nu este disponibilă, sau este o aplicație privată care nu poate merge pe un domeniu propriu. Eroarea spune care dintre ele. |
429 | Ai publicat de 100 de ori prin API azi. Numărătoarea se resetează mâine. |
502 | Publicarea a eșuat la noi, sau construirea pe gazdă a eșuat. Încearcă din nou. |
503 | Publicarea nu este disponibilă pentru scurt timp. Încearcă din nou peste un minut. |
Propozițiile exacte
| Status | error |
|---|---|
400 | Publishing would put a secret key on the open internet: ... followed by the kind of secret, the file and the line, and what to do instead. |
404 | No such app on this account. |
409 | This app has no code yet. Build it in Setherion first. |
409 | The address coffee-shop.setherion.app belongs to another app. Choose a different one. |
409 | Could not find a free address for this app. Rename it and publish again. |
409 | This app is private, and a private app can only be published on its setherion.app address. To use a domain of your own, make it public first. Otherwise try again in a moment. Nothing was published. |
429 | That is 100 publishes through the API today. The count resets tomorrow. |
502 | The build failed on the host, so this version is not online. Publish again, and if it fails again, ask for a fix in the editor. |
502 | The build was cancelled on the host, so this version is not online. Publish again. |
503 | Publishing is briefly unavailable. Try again in a minute. |
Ți-a fost de folos această pagină?
