Para empezar
Introducción
Lista, modifica y publica tus aplicaciones de Setherion, y prepáralas para las tiendas de aplicaciones, desde tu propio código.
La API de Setherion trabaja sobre tus aplicaciones desde un script, un servidor o una automatización. Las lista, modifica una a partir de una instrucción, publica una y prepara una para Google Play y la App Store. Es el mismo trabajo que haces en el editor.
La API funciona en todos los planes, también en Free. Una modificación gasta créditos igual que en el editor, y escribir la página de la tienda gasta unos pocos y requiere Pro.
URL base
https://www.setherion.com/api/v1Conserva el www. La dirección sin él hace una redirección, y una redirección pierde la cabecera Authorization, así que la petición llega sin tu clave.
Una primera petición
Crea una clave en Settings, luego en API keys, y lista tus aplicaciones con ella:
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 | Ruta | Qué hace | Acceso necesario |
|---|---|---|---|
GET | /projects | Lista tus aplicaciones, con búsqueda y páginas | Cualquiera |
POST | /projects/{id}/edit | Modifica una aplicación a partir de una instrucción | Editor |
POST | /projects/{id}/publish | Pone una aplicación online | Editor |
GET | /projects/{id}/store | Qué está listo para las tiendas de aplicaciones, y los pasos | Viewer |
GET | /projects/{id}/store/privacy | Las respuestas de privacidad de las tiendas, leídas del código | Viewer |
POST | /projects/{id}/store/listing | Escribe la página de la tienda | Editor |
El acceso es el rol que tienes en la aplicación. Viewer basta para leer; editor hace falta para cambiar algo o gastar créditos. Los propietarios y los administradores tienen ambos. Una aplicación que no puedes usar al nivel que pide una llamada responde 404, igual que una aplicación que no existe.
Cada respuesta lleva ok
Toda respuesta es JSON y tiene un campo ok. Cuando algo se rechaza, ok es false, el código de estado dice qué tipo de problema es, y error es una frase que puedes mostrar a una persona:
{ "ok": false, "error": "No such app on this account." }Consulta Errores y límites para ver cada código de estado, cada límite y las frases exactas.
Qué gasta créditos
| Llamada | Créditos |
|---|---|
| Listar, publicar, guía de tiendas, respuestas de privacidad | Ninguno |
| Modificar | Los mismos que una modificación en el editor, tomados de la cuenta que paga la aplicación |
| Escribir la página de la tienda | Unos pocos, en Pro y superiores. Se devuelven si no salió ninguna página. |
Úsala desde un asistente de IA
Si quieres que Claude, ChatGPT, Cursor o VS Code hagan esto por ti, no necesitas la API directamente. Conecta un asistente de IA en su lugar: ofrece estas mismas llamadas como herramientas, e inicias sesión sin clave.
¿Te ha sido útil esta página?