Primeiros passos
Introdução
Liste, edite e publique seus apps do Setherion, e deixe-os prontos para as lojas de apps, a partir do seu próprio código.
A API do Setherion trabalha nos seus apps a partir de um script, de um servidor ou de uma automação. Ela lista os apps, muda um a partir de uma instrução, publica um e prepara um para o Google Play e a App Store. É o mesmo trabalho que você faz no editor.
A API funciona em todos os planos, inclusive o Free. Uma edição gasta créditos como no editor, e escrever a página da loja gasta alguns e exige o Pro.
URL base
https://www.setherion.com/api/v1Mantenha o www. O endereço sem ele redireciona, e um redirecionamento perde o cabeçalho Authorization, então a solicitação chega sem a sua chave.
Uma primeira solicitação
Crie uma chave em Settings, depois API keys, e liste seus apps com ela:
curl https://www.setherion.com/api/v1/projects \
-H "Authorization: Bearer $SETHERION_API_KEY"{
"ok": true,
"total": 1,
"truncated": false,
"offset": 0,
"nextOffset": null,
"projects": [
{
"id": "7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14",
"name": "Coffee shop",
"description": null,
"url": "https://coffee-shop.setherion.app",
"updatedAt": "2026-09-19T10:42:07.000Z"
}
]
}Endpoints
| Método | Caminho | O que faz | Acesso necessário |
|---|---|---|---|
GET | /projects | Listar seus apps, com busca e páginas | Qualquer |
POST | /projects/{id}/edit | Mudar um app a partir de uma instrução | Editor |
POST | /projects/{id}/publish | Colocar um app no ar | Editor |
GET | /projects/{id}/store | O que está pronto para as lojas de apps, e os passos | Visualizador |
GET | /projects/{id}/store/privacy | As respostas de privacidade das lojas, lidas do código | Visualizador |
POST | /projects/{id}/store/listing | Escrever a página da loja | Editor |
O acesso é a função que você tem no app. Visualizador basta para ler; editor é preciso para mudar qualquer coisa ou gastar créditos. Donos e administradores têm os dois. Um app que você não pode usar no nível que uma chamada exige responde 404, igual a um app que não existe.
Toda resposta traz ok
Toda resposta é JSON com um campo ok. Quando algo é recusado, ok é false, o código de status diz que tipo de problema é, e error é uma frase que você pode mostrar a uma pessoa:
{ "ok": false, "error": "No such app on this account." }Veja Erros e limites para cada código de status, cada limite e as frases exatas.
O que custa créditos
| Chamada | Créditos |
|---|---|
| Listar, publicar, guia das lojas, respostas de privacidade | Nenhum |
| Editar | O mesmo que uma edição no editor, tirado da conta que paga pelo app |
| Escrever a página da loja | Alguns, no Pro e acima. Devolvidos se nenhuma página saiu. |
Use a partir de um assistente de IA
Se você quer que o Claude, o ChatGPT, o Cursor ou o VS Code faça isso por você, não precisa da API diretamente. Conecte um assistente de IA: ele oferece essas mesmas chamadas como ferramentas, e você entra sem uma chave.
Esta página foi útil?