Endpoints

Escrever a página da loja

Os textos da página da loja para o Google Play e a App Store, escritos a partir do que as telas do app dizem.

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

Plano: Pro and up

Escreve de uma vez só os textos da página da loja do app, para as duas lojas: o nome, as descrições curta e completa do Google Play, e o subtítulo, as palavras-chave e o texto promocional da App Store. É o mesmo trabalho do botão Write it na janela “Publish to app stores”, com a mesma regra de plano, o mesmo preço e o mesmo pagador.

Os textos vêm do que as telas do app dizem, no idioma dessas telas. O redator é instruído a nunca inventar um recurso, um preço, uma avaliação ou um número de usuários, e a não citar as lojas nem a ferramenta com que o app foi criado.

Você precisa poder editar o app, porque isto gasta os créditos dele. Nada é salvo: mostre os textos ao proprietário para copiar no Play Console e no App Store Connect.

Custo e plano

  • Créditos. Poucos, cobrados antes do trabalho, da conta que paga pelo app. O campo charged da resposta diz quantos foram tirados. Se nenhuma página utilizável saiu, eles são devolvidos.
  • Plano. Pro ou Business, da conta que paga pelo app. No Free a chamada responde 402.
  • Ritmo. O mesmo teto por hora das outras pequenas ações de IA do editor, 600 por hora por conta. Uma pessoa nunca chega a ele.

Requisição

Não é preciso corpo.

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

Leva até cerca de dois minutos. Defina o timeout do seu cliente para pelo menos 2 minutos.

Resposta

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."
  }
}
CampoTipoSignificado
languagestringO código do idioma em que os textos são escritos, lido das telas do app.
chargednumberOs créditos tirados. 0 quando o registro de créditos não pôde ser acessado e a chamada foi deixada passar.
limitsobjectO máximo de caracteres que cada campo pode ter. São os limites das próprias lojas.
textsobjectOs textos. Todos os campos estão sempre presentes.

Os campos de texts

CampoOnde vaiLimite
nameO nome do app nas duas lojas30 caracteres
googleShortGoogle Play, descrição curta80 caracteres
descriptionA descrição completa, a mesma para as duas lojas4.000 caracteres
appleSubtitleApp Store, subtítulo30 caracteres
appleKeywordsApp Store, palavras-chave, separadas por vírgulas e sem espaços100 caracteres
applePromoApp Store, texto promocional170 caracteres

Todo campo é cortado no limite, em uma palavra inteira, porque o console de uma loja recusa um campo acima do limite e um modelo de IA conta mal os caracteres. As palavras-chave também são limpas: cada uma aparece uma vez, e nenhuma repete uma palavra do nome. A descrição completa é texto simples, com as principais coisas que as pessoas podem fazer, uma por linha, cada uma começando com •.

Erros

StatusQuando
401A chave está ausente, errada ou foi revogada.
402A conta que paga pelo app está no Free, ou não tem mais créditos, ou um limite do espaço de trabalho sobre você foi atingido.
404Não existe esse app, ou sua chave não pode editá-lo.
409O app ainda não tem código. Crie-o primeiro no Setherion.
429Mais de 600 pequenas ações de IA na última hora nesta conta.
500A resposta do redator não pôde ser usada. Nada é cobrado: os créditos são devolvidos. Tente de novo.
503O limitador está brevemente indisponível, então nada foi executado. Tente de novo em um minuto.
As frases exatas
Statuserror
402Writing the store page is part of the Pro plan.
402This costs 2 credits and you have 1.
402This app's owner has no credits left this month.
402You have used the credits this workspace allows you this month. Ask an admin to raise your limit.
404No such app on this account.
409This app has no code yet. Build it in Setherion first.
429Too many AI actions in the last hour. Try again later.
500The model did not answer with the store page.
500The model's answer was cut off or not readable.
500The model left out: appleKeywords.
503Usage limits are briefly unavailable, so this was not run. Try again in a minute.

O primeiro 402 é para o Free. O número no segundo é o preço e o seu saldo; no app de outra pessoa você recebe a terceira frase, que nunca cita o saldo dela. As linhas 500 são exemplos: a frase diz o que deu errado, e os créditos são devolvidos.

Esta página foi útil?

Entre na comunidade

Perguntas, ideias e o que outras pessoas estão criando.