Puntos de acceso
Publica una aplicación
Pone en línea la aplicación guardada, igual que lo hace el botón Publish.
https://www.setherion.com/api/v1/projects/{id}/publishPlan: Cualquier plan
Pone la aplicación en línea tal como está guardada, con los mismos pasos que el botón Publish del editor. Una aplicación que ya se había publicado conserva su dirección; una que se publica por primera vez recibe una dirección hecha a partir de su nombre, en setherion.app.
Publicar no gasta créditos. Necesitas poder editar la aplicación. Está limitado a 100 publicaciones por cuenta y día a través de la API, algo que nadie que trabaje a mano alcanza; el botón del propio editor no tiene ese límite.
Solicitud
No hace falta cuerpo.
curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/publish \
-H "Authorization: Bearer $SETHERION_API_KEY"Respuesta
{ "ok": true, "url": "https://coffee-shop.setherion.app", "ready": true }| Campo | Tipo | Significado |
|---|---|---|
ok | boolean | true cuando la aplicación se publicó. |
url | string | Dónde está en línea la aplicación. |
ready | boolean | false cuando la dirección todavía se está preparando. Funciona en uno o dos minutos. |
Publicar dos veces la misma aplicación guardada es seguro: la segunda llamada responde con la misma dirección.
Edita y luego publica
Lo que se publica es lo que está guardado, y una edición se guarda cuando termina. Así que una edición seguida de una publicación pone el cambio en línea:
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)
}Errores
| Status | Cuándo |
|---|---|
400 | El código de la aplicación contiene un secreto, como una clave de API, y no se publicó. El error indica dónde. |
401 | Falta la clave, es incorrecta o fue revocada. |
404 | No existe esa aplicación, o tu clave no puede editarla. |
409 | La aplicación todavía no tiene código, o la dirección que necesita no está disponible, o es una aplicación privada que no puede ir en un dominio propio. El error dice cuál de los casos es. |
429 | Has publicado 100 veces hoy a través de la API. El recuento se reinicia mañana. |
502 | La publicación falló por nuestra parte, o falló la compilación en el servidor. Inténtalo de nuevo. |
503 | Publicar no está disponible por un momento. Inténtalo de nuevo en un minuto. |
Las frases exactas
| Status | error |
|---|---|
400 | Publishing would put a secret key on the open internet: ... seguido del tipo de secreto, el archivo y la línea, y qué hacer en su lugar. |
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. |
¿Te ha sido útil esta página?
