Erste Schritte

Einführung

Listen, ändern und veröffentlichen Sie Ihre Setherion-Apps und bereiten Sie sie für die App Stores vor, aus Ihrem eigenen Code.

Die Setherion-API arbeitet an Ihren Apps aus einem Skript, von einem Server oder aus einer Automatisierung. Sie listet sie auf, ändert eine anhand einer Anweisung, veröffentlicht eine und bereitet eine für Google Play und den App Store vor. Es ist dieselbe Arbeit, die Sie im Editor erledigen.

Die API funktioniert in jedem Tarif, auch in Free. Eine Änderung verbraucht Credits wie im Editor, und das Schreiben der Store-Seite verbraucht einige und setzt Pro voraus.

Basis-URL

text

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

Behalten Sie das www bei. Die Adresse ohne diesen Teil leitet weiter, und eine Weiterleitung verwirft den Header Authorization, sodass die Anfrage ohne Ihren Schlüssel ankommt.

Eine erste Anfrage

Erstellen Sie einen Schlüssel unter Settings, dann API-Schlüssel, und listen Sie damit Ihre Apps auf:

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

Endpunkte

Methode	Pfad	Was er tut	Erforderlicher Zugriff
`GET`	`/projects`	Ihre Apps auflisten, mit Suche und Seiten	Beliebig
`POST`	`/projects/{id}/edit`	Eine App anhand einer Anweisung ändern	Editor
`POST`	`/projects/{id}/publish`	Eine App online stellen	Editor
`GET`	`/projects/{id}/store`	Was für die App Stores bereit ist, und die Schritte	Viewer
`GET`	`/projects/{id}/store/privacy`	Die Datenschutzantworten der Stores, aus dem Code gelesen	Viewer
`POST`	`/projects/{id}/store/listing`	Die Store-Seite schreiben	Editor

Der Zugriff ist die Rolle, die Sie für die App haben. Viewer genügt zum Lesen; Editor wird gebraucht, um etwas zu ändern oder Credits auszugeben. Inhaber und Admins haben beides. Eine App, die Sie nicht auf der Stufe nutzen können, die ein Aufruf braucht, antwortet mit 404, genau wie eine App, die nicht existiert.

Jede Antwort enthält `ok`

Jede Antwort ist JSON mit einem Feld ok. Wird etwas abgelehnt, ist ok gleich false, der Statuscode sagt, um welche Art von Problem es sich handelt, und error ist ein Satz, den Sie einer Person zeigen können:

json

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

Unter Fehler und Limits finden Sie jeden Statuscode, jedes Limit und die genauen Sätze.

Was Credits kostet

Aufruf	Credits
Auflisten, Veröffentlichen, Store-Leitfaden, Datenschutzantworten	Keine
Ändern	Dasselbe wie eine Änderung im Editor, abgezogen von dem Konto, das für die App bezahlt
Die Store-Seite schreiben	Einige, ab Pro. Zurückgegeben, wenn keine Seite entstanden ist.

Aus einem KI-Assistenten nutzen

Wenn Claude, ChatGPT, Cursor oder VS Code das für Sie erledigen soll, brauchen Sie die API nicht direkt. Verbinden Sie stattdessen einen KI-Assistenten: Er bietet dieselben Aufrufe als Werkzeuge an, und Sie melden sich ohne Schlüssel an.

War diese Seite hilfreich?

Weiter

Authentifizierung

Der Community beitreten

Fragen, Ideen und was andere erstellen.