Na start

Wprowadzenie

Wyświetlaj, edytuj i publikuj swoje aplikacje Setherion oraz przygotowuj je do sklepów z aplikacjami, z własnego kodu.

API Setherion działa na twoich aplikacjach ze skryptu, serwera lub automatyzacji. Wyświetla je, zmienia jedną z nich na podstawie polecenia, publikuje ją i przygotowuje do Google Play i App Store. To ta sama praca, którą wykonujesz w edytorze.

API działa na każdym planie, także Free. Edycja zużywa kredyty tak samo jak w edytorze, a napisanie strony sklepowej zużywa ich kilka i wymaga planu Pro.

Adres bazowy

text

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

Zostaw www. Adres bez niego przekierowuje, a przekierowanie gubi nagłówek Authorization, więc żądanie dociera bez twojego klucza.

Pierwsze żądanie

Utwórz klucz w Settings, a potem w kluczach API, i wyświetl za jego pomocą swoje aplikacje:

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

Punkty końcowe

Metoda	Ścieżka	Co robi	Wymagany dostęp
`GET`	`/projects`	Wyświetla twoje aplikacje, z wyszukiwaniem i stronami	Dowolny
`POST`	`/projects/{id}/edit`	Zmienia aplikację na podstawie polecenia	Editor
`POST`	`/projects/{id}/publish`	Wystawia aplikację online	Editor
`GET`	`/projects/{id}/store`	Co jest gotowe do sklepów z aplikacjami i jakie są kroki	Viewer
`GET`	`/projects/{id}/store/privacy`	Odpowiedzi o prywatności dla sklepów, odczytane z kodu	Viewer
`POST`	`/projects/{id}/store/listing`	Pisze stronę sklepową	Editor

Dostęp to rola, którą masz w aplikacji. Do odczytu wystarczy viewer, a do zmiany czegokolwiek lub zużycia kredytów potrzebny jest editor. Właściciele i administratorzy mają oba. Aplikacja, której nie możesz użyć na poziomie wymaganym przez wywołanie, odpowiada 404, tak samo jak aplikacja, która nie istnieje.

Każda odpowiedź zawiera `ok`

Każda odpowiedź to JSON z polem ok. Gdy coś zostaje odrzucone, ok ma wartość false, kod statusu mówi, jakiego rodzaju jest problem, a error to zdanie, które możesz pokazać człowiekowi:

json

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

Wszystkie kody statusu, wszystkie limity i dokładne zdania znajdziesz w Błędy i limity.

Co kosztuje kredyty

Wywołanie	Kredyty
Lista, publikowanie, przewodnik po sklepach, odpowiedzi o prywatności	Brak
Edycja	Tyle samo co edycja w edytorze, pobrane z konta, które płaci za aplikację
Napisanie strony sklepowej	Kilka, w planie Pro i wyższych. Zwracane, jeśli nie powstała żadna strona.

Użyj go z asystenta AI

Jeśli chcesz, żeby zrobił to za ciebie Claude, ChatGPT, Cursor lub VS Code, nie potrzebujesz bezpośrednio API. Podłącz zamiast tego asystenta AI: udostępnia te same wywołania jako narzędzia, a logujesz się bez klucza.

Czy ta strona była pomocna?

Dalej

Uwierzytelnianie

Dołącz do społeczności

Pytania, pomysły i to, co budują inni.