레퍼런스
오류와 제한
각 상태 코드가 무엇을 뜻하는지, 오류의 정확한 문장, 그리고 얼마나 할 수 있는지 알려 줘요.
오류의 형태
모든 응답에는 ok 필드가 있어요. 요청이 거부되면 ok는 false이고, error에는 무엇이 잘못되었고 어떻게 해야 하는지를 알려 주는 문장이 들어 있어요. 사람에게 그대로 보여 줄 수 있게 쓰여 있어요.
json
{ "ok": false, "error": "No such app on this account." }거부 응답에는 다른 필드가 없어요. 예외가 하나 있어요. 시작된 앱 수정이 크레딧이 부족해 실행되지 못했다면 outOfCredits: true도 함께 들어 있어요.
상태 코드
| 상태 | 의미 | 대처 방법 |
|---|---|---|
200 | 완료됐어요. 수정의 경우 시작되었다는 뜻이고, 어떻게 끝났는지는 ok가 알려 줘요. | ok를 읽으세요. |
400 | 요청에 빠진 것이나 허용되지 않는 것이 있어요. | error를 보고 요청을 고치세요. |
401 | 키가 없거나 틀렸거나 폐기되었어요. | Authorization 헤더와 키를 확인하세요. |
402 | 이 호출은 크레딧을 쓰는데 쓸 수 없어요. 요금제에 포함되어 있지 않거나 크레딧이 부족해요. | error가 안내하는 대로 업그레이드하거나 크레딧을 추가하세요. |
404 | 그런 앱이 없거나, 내 키로는 이 호출에 필요한 수준으로 그 앱을 쓸 수 없어요. | 내 앱 목록 조회로 id를 확인하세요. |
409 | 앱에 아직 코드가 없거나, 게시할 때 그 주소를 쓸 수 없어요. | 먼저 Setherion에서 만들거나 error를 읽으세요. |
429 | 한도에 도달했어요. | 초기화될 때까지 기다리세요. |
500 | 저희 쪽에서 무언가 실패했어요. | 다시 시도하세요. |
502 | 저희 쪽에서 게시에 실패했어요. | 다시 시도하세요. |
503 | Setherion의 일부가 잠시 사용할 수 없어요. | 1분 뒤에 다시 시도하세요. |
개인정보 보호를 위해, “그런 앱이 없음”과 “내가 쓸 수 없는 앱”은 똑같은 404를 돌려줘요. 그렇지 않으면 키로 어떤 앱이 존재하는지 알아낼 수 있기 때문이에요. 호출에 편집자 권한이 필요한데 내가 볼 수만 있는 앱도 여기에 포함돼요.
누가 무엇을 할 수 있는지
앱에서의 내 역할이 어떤 호출이 동작하는지를 정해요.
| 역할 | 읽기(목록, 스토어 가이드, 개인정보 답변) | 변경하고 크레딧 사용(수정, 게시, 스토어 페이지) |
|---|---|---|
| 뷰어 | 예 | 아니요, 404 |
| 편집자 | 예 | 예 |
| 관리자, 소유자 | 예 | 예 |
한도
| 항목 | 한도 |
|---|---|
| 활성 API 키 | 계정당 10개 |
| API로 게시 | 계정당 하루 100번 |
| 수정과 빌드 | 계정당 시간당 120번 |
| 작성한 스토어 페이지 | 계정의 작은 AI 작업과 함께 세며, 시간당 600번 |
| 수정 지시문의 길이 | 4,000자 |
검색(q)의 길이 | 100자 |
| 목록이 돌려주는 앱 | 페이지당 100개, 가장 최근에 바뀐 것부터. 다음 페이지는 내 앱 목록 조회를 참고하세요. |
| 수정에 걸릴 수 있는 시간 | 최대 약 13분 |
| 스토어 페이지에 걸릴 수 있는 시간 | 최대 약 2분 |
시간당 한도는 허용량이 아니라 속도 조절이에요. 사람보다 빠르게 실행되는 스크립트를 위한 것이고, 손으로 작업하는 사람은 거기에 닿지 않아요. 실제로 한도가 되는 것은 크레딧이에요.
수정은 에디터에서와 똑같이 크레딧과 요금제로도 제한돼요. 그 이유로 수정을 실행할 수 없으면, 응답은 200에 ok: false이고 error가 이유를 알려 줘요. 스토어 페이지는 달라요. 거부될 때 아직 시작되지 않은 상태이므로 402로 응답해요.
어떤 한도가 어떻게 응답하는지
- 게시는 그날의 100번을 다 쓰면
429로 응답하고, 한도 확인 장치 자체에 닿을 수 없을 때는503으로 응답해요. - 스토어 페이지는 시간당 한도에는
429로, 한도 확인 장치에 닿을 수 없을 때는503으로, 요금제와 크레딧 문제에는402로 응답해요. - 수정은
200에ok: false로 응답하고,error에 문장이 들어 있어요. 시간당 한도에 걸리면 다음 문장이 나와요:You're working faster than our safety limit allows (120 an hour). You can carry on in about 12 minutes.
모든 호출이 응답할 수 있는 문장
| 상태 | error |
|---|---|
401 | A valid API key is required. Make one on your Setherion account page and send it as "Authorization: Bearer sth_...". |
404 | No such app on this account. |
500 | The API is not configured on this server. |
각 호출의 문장
- 내 앱 목록 조회:
q is at most 100 characters.offset is a whole number, 0 or more.Could not list your apps. - 앱 수정:
Say what to change, in "prompt".Keep "prompt" under 4,000 characters.This app has no code yet. Build it in Setherion first, then edit it here. - 앱 게시:
That is 100 publishes through the API today. The count resets tomorrow.Publishing is briefly unavailable. Try again in a minute.Publishing through the API is not configured on this server.그리고 그 페이지에 나열된 시크릿, 주소, 비공개 앱, 빌드에 관한 문장도 있어요. - 스토어 준비 가이드와 스토어 개인정보 답변:
way is "easy" or "native".This app has no code yet. Build it in Setherion first. - 스토어 페이지 작성:
Writing the store page is part of the Pro plan.Too many AI actions in the last hour. Try again later.그리고 그 페이지에 나열된 크레딧 문장도 있어요.
이 페이지가 도움이 됐나요?