Endpunkte

Eine App veröffentlichen

Bringen Sie die gespeicherte App online, so wie es die Schaltfläche Publish tut.

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

Tarif: Jeder Tarif

Bringt die App genau so online, wie sie gespeichert ist, über dieselben Schritte wie die Schaltfläche Publish im Editor. Eine App, die schon einmal veröffentlicht war, behält ihre Adresse; eine App, die zum ersten Mal veröffentlicht wird, erhält eine Adresse aus ihrem Namen auf setherion.app.

Das Veröffentlichen verbraucht keine Credits. Sie müssen die App bearbeiten dürfen. Über die API sind es höchstens 100 Veröffentlichungen pro Konto und Tag, was von Hand niemand erreicht; die Schaltfläche im Editor hat kein solches Limit.

Anfrage

Es ist kein Body nötig.

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

Antwort

json
{ "ok": true, "url": "https://coffee-shop.setherion.app", "ready": true }
FeldTypBedeutung
okbooleantrue, wenn die App veröffentlicht wurde.
urlstringWo die App online ist.
readybooleanfalse, wenn die Adresse noch eingerichtet wird. Sie funktioniert innerhalb von ein bis zwei Minuten.

Dieselbe gespeicherte App zweimal zu veröffentlichen ist unbedenklich: Der zweite Aufruf antwortet mit derselben Adresse.

Ändern, dann veröffentlichen

Veröffentlicht wird, was gespeichert ist, und eine Änderung wird gespeichert, wenn sie fertig ist. Eine Änderung gefolgt von einer Veröffentlichung bringt die Änderung also 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)
}

Fehler

StatusWann
400Der Code der App enthält ein Secret, etwa einen API-Schlüssel, und wurde nicht veröffentlicht. Der Fehler nennt die Stelle.
401Der Schlüssel fehlt, ist falsch oder wurde widerrufen.
404Es gibt keine solche App, oder Ihr Schlüssel darf sie nicht ändern.
409Die App hat noch keinen Code, oder die Adresse, die sie braucht, ist nicht verfügbar, oder es ist eine private App, die nicht auf eine eigene Domain kann. Der Fehler sagt, was zutrifft.
429Sie haben heute 100-mal über die API veröffentlicht. Der Zähler wird morgen zurückgesetzt.
502Das Veröffentlichen ist auf unserer Seite fehlgeschlagen, oder der Build beim Host ist fehlgeschlagen. Versuchen Sie es erneut.
503Das Veröffentlichen ist kurzzeitig nicht verfügbar. Versuchen Sie es in einer Minute erneut.
Die genauen Sätze
Statuserror
400Publishing would put a secret key on the open internet: ... gefolgt von der Art des Secrets, der Datei und der Zeile sowie dem, was Sie stattdessen tun können.
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.

War diese Seite hilfreich?

Der Community beitreten

Fragen, Ideen und was andere erstellen.