はじめに

はじめに

Setherionのアプリの一覧取得、編集、公開と、アプリストア公開の準備を、ご自身のコードから行います。

Setherion APIを使うと、スクリプト、サーバー、自動化の仕組みからアプリを操作できます。アプリの一覧取得、指示にもとづく変更、公開、そしてGoogle PlayとApp Storeに向けた準備ができます。エディタで行う作業と同じものです。

APIはFreeを含むすべてのプランで使えます。編集はエディタと同じようにクレジットを使い、ストアページの作成には少量のクレジットがかかり、Proが必要です。

ベースURL

text

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

wwwを付けたままにしてください。付けないアドレスはリダイレクトされ、リダイレクトではAuthorizationヘッダーが失われるため、キーのないリクエストが届くことになります。

最初のリクエスト

Settings、続けてAPIキーでキーを作り、そのキーでアプリの一覧を取得します。

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

エンドポイント

メソッド	パス	内容	必要なアクセス
`GET`	`/projects`	検索とページ送りつきでアプリの一覧を取得する	どれでも可
`POST`	`/projects/{id}/edit`	指示にもとづいてアプリを変更する	Editor
`POST`	`/projects/{id}/publish`	アプリをオンラインにする	Editor
`GET`	`/projects/{id}/store`	アプリストア向けに何が整っているかと、次の手順	Viewer
`GET`	`/projects/{id}/store/privacy`	コードから読み取ったストアのプライバシー回答	Viewer
`POST`	`/projects/{id}/store/listing`	ストアページを書く	Editor

アクセスとは、そのアプリで持っているロールのことです。読み取りにはViewerで足り、変更やクレジットの消費にはEditorが必要です。オーナーと管理者は両方を持っています。呼び出しに必要なレベルで使えないアプリには、存在しないアプリと同じく404が返ります。

すべての応答に`ok`が付きます

すべての応答はokフィールドを持つJSONです。何かが拒否されるとokはfalseになり、ステータスコードが問題の種類を示し、errorには人に見せられる1文が入ります。

json

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

すべてのステータスコード、上限、正確な文言はエラーと制限をご覧ください。

クレジットがかかるもの

呼び出し	クレジット
一覧取得、公開、ストアガイド、プライバシー回答	なし
編集	エディタでの編集と同じで、アプリの費用を負担するアカウントから引かれます
ストアページの作成	少量です（Pro以上）。ページができなかった場合は返却されます

AIアシスタントから使う

ClaudeやChatGPT、Cursor、VS Codeにこれを任せたい場合は、APIを直接使う必要はありません。代わりにMCP：AIアシスタントを接続するをご覧ください。同じ呼び出しがツールとして提供され、キーなしでログインできます。

このページは役に立ちましたか？

認証

コミュニティに参加