Endpointuri

Publică o aplicație

Pune online aplicația salvată, la fel ca butonul Publish.

POSThttps://www.setherion.com/api/v1/projects/{id}/publish

Plan: 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.

bash
curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/publish \
  -H "Authorization: Bearer $SETHERION_API_KEY"

Răspunsul

json
{ "ok": true, "url": "https://coffee-shop.setherion.app", "ready": true }
CâmpTipCe înseamnă
okbooleantrue când aplicația a fost publicată.
urlstringUnde este aplicația online.
readybooleanfalse 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:

js
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

StatusCând
400Codul aplicației conține un secret, de pildă o cheie API, și nu a fost publicat. Eroarea spune unde.
401Cheia lipsește, e greșită sau a fost revocată.
404Nu există o asemenea aplicație sau cheia ta nu o poate modifica.
409Aplicaț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.
429Ai publicat de 100 de ori prin API azi. Numărătoarea se resetează mâine.
502Publicarea a eșuat la noi, sau construirea pe gazdă a eșuat. Încearcă din nou.
503Publicarea nu este disponibilă pentru scurt timp. Încearcă din nou peste un minut.
Propozițiile exacte
Statuserror
400Publishing 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.
404No such app on this account.
409This app has no code yet. Build it in Setherion first.
409The address coffee-shop.setherion.app belongs to another app. Choose a different one.
409Could not find a free address for this app. Rename it and publish again.
409This 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.
429That is 100 publishes through the API today. The count resets tomorrow.
502The 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.
502The build was cancelled on the host, so this version is not online. Publish again.
503Publishing is briefly unavailable. Try again in a minute.

Ți-a fost de folos această pagină?

Alătură-te comunității

Întrebări, idei și ce construiesc alții.