Endpoints

Publicar um app

Coloque no ar o app salvo, como faz o botão Publish.

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

Plano: Qualquer plano

Coloca o app no ar exatamente como está salvo, pelos mesmos passos do botão Publish do editor. Um app que já foi publicado antes mantém o seu endereço; um publicado pela primeira vez recebe um endereço feito a partir do seu nome, em setherion.app.

Publicar não usa créditos. Você precisa poder editar o app. Pela API, o limite é de 100 publicações por conta por dia, que ninguém que trabalha à mão alcança; o botão do próprio editor não tem esse limite.

Solicitação

Não é preciso enviar corpo.

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

Resposta

json
{ "ok": true, "url": "https://coffee-shop.setherion.app", "ready": true }
CampoTipoSignificado
okbooleanotrue quando o app foi publicado.
urltextoOnde o app está no ar.
readybooleanofalse quando o endereço ainda está sendo configurado. Ele funciona em um ou dois minutos.

Publicar o mesmo app salvo duas vezes é seguro: a segunda chamada responde com o mesmo endereço.

Editar e depois publicar

O que fica publicado é o que está salvo, e uma edição é salva quando termina. Então uma edição seguida de uma publicação coloca a alteração no ar:

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

Erros

StatusQuando
400O código do app contém um segredo, como uma chave de API, e não foi publicado. O erro diz onde.
401A chave está ausente, errada ou foi revogada.
404Não existe esse app, ou a sua chave não consegue editá-lo.
409O app ainda não tem código, ou o endereço de que ele precisa não está disponível, ou é um app privado que não pode ir para um domínio próprio. O erro diz qual dos casos.
429Você publicou 100 vezes pela API hoje. A contagem zera amanhã.
502A publicação falhou do nosso lado, ou a compilação na hospedagem falhou. Tente de novo.
503A publicação está indisponível por um momento. Tente de novo em um minuto.
As frases exatas
Statuserror
400Publishing would put a secret key on the open internet: ... seguido do tipo de segredo, do arquivo e da linha, e do que fazer em vez disso.
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.

Esta página foi útil?

Entre na comunidade

Perguntas, ideias e o que outras pessoas estão criando.