시작하기

소개

직접 작성한 코드에서 Setherion 앱을 조회하고, 수정하고, 게시하고, 앱 스토어에 낼 준비까지 할 수 있어요.

Setherion API는 스크립트, 서버, 자동화 도구에서 여러분의 앱을 다뤄요. 앱 목록을 보여 주고, 지시문으로 앱을 수정하고, 앱을 게시하고, Google Play와 App Store에 낼 준비를 해요. 에디터에서 하는 일과 같은 작업이에요.

API는 Free를 포함한 모든 요금제에서 쓸 수 있어요. 수정은 에디터에서처럼 크레딧을 쓰고, 스토어 페이지를 작성하면 크레딧을 조금 쓰며 Pro가 필요해요.

기본 URL

text

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

www를 꼭 붙이세요. 이것이 없는 주소는 리디렉션되는데, 리디렉션되면 Authorization 헤더가 사라져서 요청이 키 없이 도착해요.

첫 번째 요청

Settings에서 API keys로 가서 키를 만들고, 그 키로 앱 목록을 가져와 보세요.

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에는 사람에게 보여 줄 수 있는 문장이 들어 있어요.

json

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

모든 상태 코드와 한도, 정확한 문장은 오류와 제한을 보세요.

크레딧이 드는 작업

호출	크레딧
조회, 게시, 스토어 가이드, 개인정보 답변	없음
수정	에디터에서 수정할 때와 같고, 앱 비용을 내는 계정에서 차감돼요
스토어 페이지 작성	소량이며 Pro 이상에서 쓸 수 있어요. 페이지가 만들어지지 않으면 돌려받아요

AI 어시스턴트에서 사용하기

Claude, ChatGPT, Cursor 또는 VS Code가 이 일을 해 주기를 원한다면 API를 직접 쓸 필요가 없어요. 대신 MCP: AI 어시스턴트 연결하기를 보세요. 같은 호출을 도구로 제공하고, 키 없이 로그인할 수 있어요.

이 페이지가 도움이 됐나요?

인증

커뮤니티 참여하기

질문, 아이디어, 그리고 다른 사람들이 만들고 있는 것.