Endpunkte
Eine App veröffentlichen
Bringen Sie die gespeicherte App online, so wie es die Schaltfläche Publish tut.
https://www.setherion.com/api/v1/projects/{id}/publishTarif: 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.
curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/publish \
-H "Authorization: Bearer $SETHERION_API_KEY"Antwort
{ "ok": true, "url": "https://coffee-shop.setherion.app", "ready": true }| Feld | Typ | Bedeutung |
|---|---|---|
ok | boolean | true, wenn die App veröffentlicht wurde. |
url | string | Wo die App online ist. |
ready | boolean | false, 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:
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
| Status | Wann |
|---|---|
400 | Der Code der App enthält ein Secret, etwa einen API-Schlüssel, und wurde nicht veröffentlicht. Der Fehler nennt die Stelle. |
401 | Der Schlüssel fehlt, ist falsch oder wurde widerrufen. |
404 | Es gibt keine solche App, oder Ihr Schlüssel darf sie nicht ändern. |
409 | Die 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. |
429 | Sie haben heute 100-mal über die API veröffentlicht. Der Zähler wird morgen zurückgesetzt. |
502 | Das Veröffentlichen ist auf unserer Seite fehlgeschlagen, oder der Build beim Host ist fehlgeschlagen. Versuchen Sie es erneut. |
503 | Das Veröffentlichen ist kurzzeitig nicht verfügbar. Versuchen Sie es in einer Minute erneut. |
Die genauen Sätze
| Status | error |
|---|---|
400 | Publishing 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. |
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. |
War diese Seite hilfreich?
