Pour commencer
Introduction
Listez, modifiez et publiez vos applications Setherion, et préparez-les pour les stores, depuis votre propre code.
L’API Setherion agit sur vos applications depuis un script, un serveur ou une automatisation. Elle les liste, modifie l’une d’elles à partir d’une instruction, en publie une, et en prépare une pour Google Play et l’App Store. C’est le même travail que celui que vous faites dans l’éditeur.
L’API fonctionne avec tous les forfaits, Free compris. Une modification dépense des crédits comme dans l’éditeur, et la rédaction de la fiche du store en dépense quelques-uns et demande Pro.
URL de base
https://www.setherion.com/api/v1Gardez le www. L’adresse sans lui redirige, et une redirection perd l’en-tête Authorization, si bien que la requête arrive sans votre clé.
Une première requête
Créez une clé dans Settings, puis API keys, et listez vos applications avec elle :
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éthode | Chemin | Ce que cela fait | Accès nécessaire |
|---|---|---|---|
GET | /projects | Lister vos applications, avec recherche et pages | Tout accès |
POST | /projects/{id}/edit | Modifier une application à partir d’une instruction | Editor |
POST | /projects/{id}/publish | Mettre une application en ligne | Editor |
GET | /projects/{id}/store | Ce qui est prêt pour les stores, et les étapes | Viewer |
GET | /projects/{id}/store/privacy | Les réponses de confidentialité des stores, lues dans le code | Viewer |
POST | /projects/{id}/store/listing | Rédiger la fiche du store | Editor |
L’accès correspond au rôle que vous avez sur l’application. Viewer suffit pour lire ; editor est nécessaire pour modifier quoi que ce soit ou dépenser des crédits. Les propriétaires et les administrateurs ont les deux. Une application que vous ne pouvez pas utiliser au niveau qu’un appel exige répond 404, comme une application qui n’existe pas.
Chaque réponse contient ok
Chaque réponse est en JSON et comporte un champ ok. Quand quelque chose est refusé, ok vaut false, le code d’état indique de quel type de problème il s’agit, et error est une phrase que vous pouvez montrer à une personne :
{ "ok": false, "error": "No such app on this account." }Consultez Erreurs et limites pour chaque code d’état, chaque limite et les phrases exactes.
Ce qui coûte des crédits
| Appel | Crédits |
|---|---|
| Lister, publier, guide des stores, réponses de confidentialité | Aucun |
| Modifier | Les mêmes qu’une modification dans l’éditeur, prélevés sur le compte qui paie l’application |
| Rédiger la fiche du store | Quelques-uns, avec Pro et au-dessus. Rendus si aucune fiche n’a été produite. |
L’utiliser depuis un assistant d’IA
Si vous voulez que Claude, ChatGPT, Cursor ou VS Code le fasse pour vous, vous n’avez pas besoin de l’API directement. Connectez plutôt un assistant d’IA : il propose ces mêmes appels comme outils, et vous vous connectez sans clé.
Cette page vous a-t-elle été utile ?