Introduzione

L’API di Setherion lavora sulle tue app da uno script, da un server o da un’automazione. Le elenca, ne modifica una a partire da un’istruzione, ne pubblica una e ne prepara una per Google Play e l’App Store. È lo stesso lavoro che fai nell’editor.

L’API funziona con ogni piano, anche quello Free. Una modifica spende crediti come nell’editor, e scrivere la scheda dello store ne spende alcuni e richiede Pro.

URL di base

https://www.setherion.com/api/v1

Una prima richiesta

Crea una chiave in Settings, poi API keys, ed elenca con essa le tue app:

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"
    }
  ]
}

Endpoint

L’accesso è il ruolo che hai sull’app. Viewer basta per leggere; editor serve per cambiare qualsiasi cosa o spendere crediti. Proprietari e admin hanno entrambi. Un’app che non puoi usare al livello che una chiamata richiede risponde 404, come un’app che non esiste.

Ogni risposta contiene ok

Ogni risposta è JSON con un campo ok. Quando qualcosa viene rifiutato, ok è false, il codice di stato dice che tipo di problema è, e error è una frase che puoi mostrare a una persona:

{ "ok": false, "error": "No such app on this account." }

Vedi Errori e limiti per ogni codice di stato, ogni limite e le frasi esatte.

Che cosa costa crediti

Usarla da un assistente IA

Se vuoi che Claude, ChatGPT, Cursor o VS Code lo facciano per te, non ti serve l’API direttamente. Collega un assistente IA invece: offre queste stesse chiamate come strumenti, e accedi senza una chiave.