Puntos de acceso

Publica una aplicación

Pone en línea la aplicación guardada, igual que lo hace el botón Publish.

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

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

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

Respuesta

json
{ "ok": true, "url": "https://coffee-shop.setherion.app", "ready": true }
CampoTipoSignificado
okbooleantrue cuando la aplicación se publicó.
urlstringDónde está en línea la aplicación.
readybooleanfalse 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:

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)
}

Errores

StatusCuándo
400El código de la aplicación contiene un secreto, como una clave de API, y no se publicó. El error indica dónde.
401Falta la clave, es incorrecta o fue revocada.
404No existe esa aplicación, o tu clave no puede editarla.
409La 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.
429Has publicado 100 veces hoy a través de la API. El recuento se reinicia mañana.
502La publicación falló por nuestra parte, o falló la compilación en el servidor. Inténtalo de nuevo.
503Publicar no está disponible por un momento. Inténtalo de nuevo en un minuto.
Las frases exactas
Statuserror
400Publishing 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.
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.

¿Te ha sido útil esta página?

Únete a la comunidad

Preguntas, ideas y lo que otros están construyendo.