Ca să începi

Introducere

Listează, modifică și publică aplicațiile tale Setherion și pregătește-le pentru magazinele de aplicații, din propriul tău cod.

API-ul Setherion lucrează pe aplicațiile tale dintr-un script, de pe un server sau dintr-o automatizare. Le listează, modifică una pe baza unei instrucțiuni, publică una și pregătește una pentru Google Play și App Store. Este aceeași muncă pe care o faci în editor.

API-ul merge pe orice plan, inclusiv Free. O modificare consumă credite la fel ca în editor, iar scrierea paginii din magazin consumă câteva și cere Pro.

Adresa de bază

text

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

Păstrează www. Adresa fără el face o redirecționare, iar redirecționarea pierde antetul Authorization, așa că cererea ajunge fără cheia ta.

O primă cerere

Creează o cheie în Settings, apoi în API keys, și listează-ți aplicațiile cu ea:

bash

curl https://www.setherion.com/api/v1/projects \
  -H "Authorization: Bearer $SETHERION_API_KEY"

json

{
  "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-uri

Metodă	Cale	Ce face	Acces necesar
`GET`	`/projects`	Listează-ți aplicațiile, cu căutare și pagini	Oricare
`POST`	`/projects/{id}/edit`	Modifică o aplicație pe baza unei instrucțiuni	Editor
`POST`	`/projects/{id}/publish`	Pune o aplicație online	Editor
`GET`	`/projects/{id}/store`	Ce este pregătit pentru magazinele de aplicații, și pașii	Viewer
`GET`	`/projects/{id}/store/privacy`	Răspunsurile de confidențialitate ale magazinelor, citite din cod	Viewer
`POST`	`/projects/{id}/store/listing`	Scrie pagina din magazin	Editor

Accesul este rolul pe care îl ai în aplicație. Viewer e de ajuns ca să citești; editor trebuie ca să schimbi ceva sau să consumi credite. Proprietarii și administratorii le au pe amândouă. O aplicație pe care nu o poți folosi la nivelul cerut de un apel răspunde 404, la fel ca o aplicație care nu există.

Fiecare răspuns are `ok`

Fiecare răspuns este JSON și are un câmp ok. Când ceva este refuzat, ok este false, codul de stare spune ce fel de problemă e, iar error este o propoziție pe care o poți arăta unui om:

json

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

Vezi Erori și limite pentru fiecare cod de stare, fiecare limită și propozițiile exacte.

Ce consumă credite

Apel	Credite
Listare, publicare, ghidul pentru magazine, răspunsurile de confidențialitate	Niciunul
Modificare	Aceleași ca la o modificare în editor, luate din contul care plătește aplicația
Scrierea paginii din magazin	Câteva, pe Pro și mai sus. Date înapoi dacă nu a ieșit nicio pagină.

Folosește-l dintr-un asistent AI

Dacă vrei ca Claude, ChatGPT, Cursor sau VS Code să facă asta pentru tine, nu ai nevoie de API direct. Conectează un asistent AI în schimb: el oferă aceleași apeluri ca instrumente, iar tu te autentifici fără o cheie.

Ți-a fost de folos această pagină?

Următoarea

Autentificare

Alătură-te comunității

Întrebări, idei și ce construiesc alții.