Endpoints
Publicar um app
Coloque no ar o app salvo, como faz o botão Publish.
https://www.setherion.com/api/v1/projects/{id}/publishPlano: 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.
curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/publish \
-H "Authorization: Bearer $SETHERION_API_KEY"Resposta
{ "ok": true, "url": "https://coffee-shop.setherion.app", "ready": true }| Campo | Tipo | Significado |
|---|---|---|
ok | booleano | true quando o app foi publicado. |
url | texto | Onde o app está no ar. |
ready | booleano | false 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:
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
| Status | Quando |
|---|---|
400 | O código do app contém um segredo, como uma chave de API, e não foi publicado. O erro diz onde. |
401 | A chave está ausente, errada ou foi revogada. |
404 | Não existe esse app, ou a sua chave não consegue editá-lo. |
409 | O 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. |
429 | Você publicou 100 vezes pela API hoje. A contagem zera amanhã. |
502 | A publicação falhou do nosso lado, ou a compilação na hospedagem falhou. Tente de novo. |
503 | A publicação está indisponível por um momento. Tente de novo em um minuto. |
As frases exatas
| Status | error |
|---|---|
400 | Publishing 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. |
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. |
Esta página foi útil?
