엔드포인트

스토어 페이지 작성

Google Play와 App Store의 스토어 페이지 문구를 앱 화면에 쓰여 있는 내용을 바탕으로 작성해요.

POSThttps://www.setherion.com/api/v1/projects/{id}/store/listing

요금제: Pro and up

앱의 스토어 페이지에 들어갈 문구를 두 스토어 모두에 대해 한 번에 작성해요. 이름, Google Play의 짧은 설명과 전체 설명, App Store의 부제, 키워드, 프로모션 텍스트예요. “Publish to app stores” 창의 Write it 버튼과 같은 작업이고, 요금제 조건, 가격, 비용을 부담하는 사람도 같아요.

문구는 앱 화면에 쓰여 있는 내용을 바탕으로, 그 화면의 언어로 작성돼요. 작성기에는 기능, 가격, 평점, 사용자 수를 절대 지어내지 말고 스토어나 앱을 만든 도구의 이름을 언급하지 말라고 지시해 두었어요.

앱을 수정할 수 있는 권한이 필요해요. 이 작업은 앱의 크레딧을 쓰기 때문이에요. 아무것도 저장되지 않아요. 소유자에게 문구를 보여 주고 Play Console과 App Store Connect에 복사해 넣게 하세요.

비용과 요금제

크레딧: 몇 크레딧이 작업 전에 앱의 비용을 부담하는 계정에 청구돼요. 응답의 charged 필드에 차감된 수가 들어 있어요. 쓸 수 있는 페이지가 만들어지지 않으면 크레딧은 돌려받아요.
요금제: 앱의 비용을 부담하는 계정의 Pro 또는 Business예요. Free에서는 호출이 402로 응답해요.
속도: 에디터의 다른 작은 AI 작업과 같은 시간당 상한으로, 계정당 시간당 600회예요. 사람이 쓰다가 여기에 닿는 일은 없어요.

요청

본문은 필요 없어요.

bash

curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store/listing \
  -H "Authorization: Bearer $SETHERION_API_KEY"

최대 2분 정도 걸려요. 클라이언트의 타임아웃을 2분 이상으로 설정하세요.

응답

json

{
  "ok": true,
  "language": "en",
  "charged": 2,
  "limits": {
    "name": 30,
    "googleShort": 80,
    "description": 4000,
    "appleSubtitle": 30,
    "appleKeywords": 100,
    "applePromo": 170
  },
  "texts": {
    "name": "Coffee Shop",
    "googleShort": "Order your coffee and cake ahead and skip the queue.",
    "description": "Coffee Shop is for anyone in Leeds who wants a good coffee without waiting. Browse the menu, choose what you like and collect it when it is ready.\n\n• Browse the full menu with prices\n• Order ahead for collection\n• See the opening hours\n• Find the shop on the map\n\nPick your favourite and skip the queue.",
    "appleSubtitle": "Order ahead, skip the queue",
    "appleKeywords": "coffee,cafe,order ahead,takeaway,cake,Leeds",
    "applePromo": "Your morning coffee, ready when you arrive. Open the menu, order ahead and collect it without waiting."
  }
}

필드	타입	의미
`language`	string	문구가 작성된 언어의 코드예요. 앱의 화면에서 읽어요.
`charged`	number	차감된 크레딧이에요. 크레딧 장부에 연결할 수 없어서 호출이 그대로 통과되었을 때는 `0`이에요.
`limits`	object	각 필드에 허용되는 최대 글자 수예요. 스토어 자체의 기준이에요.
`texts`	object	문구예요. 모든 필드가 항상 들어 있어요.

`texts`의 필드

필드	사용되는 곳	한도
`name`	두 스토어의 앱 이름	30자
`googleShort`	Google Play, 짧은 설명	80자
`description`	전체 설명, 두 스토어 공통	4,000자
`appleSubtitle`	App Store, 부제	30자
`appleKeywords`	App Store, 키워드. 쉼표로 구분하고 공백은 넣지 않아요	100자
`applePromo`	App Store, 프로모션 텍스트	170자

모든 필드는 한도에 맞춰 단어 단위로 잘려요. 스토어 콘솔은 한도를 넘는 필드를 거부하고, 모델은 글자 수를 잘 세지 못하기 때문이에요. 키워드도 정리돼요. 각 키워드는 한 번만 나오고, 앱 이름에 있는 단어는 반복하지 않아요. 전체 설명은 일반 텍스트이고, 사람들이 할 수 있는 주요 일이 한 줄에 하나씩 •로 시작해요.

오류

상태	발생하는 경우
`401`	키가 없거나, 잘못되었거나, 취소되었어요.
`402`	앱의 비용을 부담하는 계정이 Free이거나, 크레딧이 남아 있지 않거나, 나에게 설정된 워크스페이스 한도에 도달했어요.
`404`	해당하는 앱이 없거나, 내 키로는 그 앱을 수정할 수 없어요.
`409`	앱에 아직 코드가 없어요. 먼저 Setherion에서 만드세요.
`429`	이 계정에서 지난 1시간 동안 작은 AI 작업이 600회를 넘었어요.
`500`	작성기의 응답을 쓸 수 없었어요. 아무것도 청구되지 않고 크레딧은 돌려받아요. 다시 시도하세요.
`503`	한도 확인 기능을 잠시 쓸 수 없어서 아무것도 실행되지 않았어요. 1분 뒤에 다시 시도하세요.

정확한 문장

상태	`error`
`402`	`Writing the store page is part of the Pro plan.`
`402`	`This costs 2 credits and you have 1.`
`402`	`This app's owner has no credits left this month.`
`402`	`You have used the credits this workspace allows you this month. Ask an admin to raise your limit.`
`404`	`No such app on this account.`
`409`	`This app has no code yet. Build it in Setherion first.`
`429`	`Too many AI actions in the last hour. Try again later.`
`500`	`The model did not answer with the store page.`
`500`	`The model's answer was cut off or not readable.`
`500`	`The model left out: appleKeywords.`
`503`	`Usage limits are briefly unavailable, so this was not run. Try again in a minute.`

첫 번째 402는 Free용이에요. 두 번째 문장의 숫자는 가격과 내 잔액이에요. 다른 사람의 앱에서는 대신 세 번째 문장이 나오고, 이 문장에는 그 사람의 잔액이 나오지 않아요. 500 행은 예시예요. 문장은 무엇이 잘못되었는지 알려 주고, 크레딧은 돌려받아요.

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

스토어 개인정보 답변

MCP 서버

커뮤니티 참여하기

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

스토어 페이지 작성

비용과 요금제

요청

응답

texts의 필드

오류

`texts`의 필드