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.
https://www.setherion.com/api/v1/projects/{id}/store/listingPlano: 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
chargedda 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.
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
{
"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."
}
}| Campo | Tipo | Significado |
|---|---|---|
language | string | O código do idioma em que os textos são escritos, lido das telas do app. |
charged | number | Os créditos tirados. 0 quando o registro de créditos não pôde ser acessado e a chamada foi deixada passar. |
limits | object | O máximo de caracteres que cada campo pode ter. São os limites das próprias lojas. |
texts | object | Os textos. Todos os campos estão sempre presentes. |
Os campos de texts
| Campo | Onde vai | Limite |
|---|---|---|
name | O nome do app nas duas lojas | 30 caracteres |
googleShort | Google Play, descrição curta | 80 caracteres |
description | A descrição completa, a mesma para as duas lojas | 4.000 caracteres |
appleSubtitle | App Store, subtítulo | 30 caracteres |
appleKeywords | App Store, palavras-chave, separadas por vírgulas e sem espaços | 100 caracteres |
applePromo | App Store, texto promocional | 170 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
| Status | Quando |
|---|---|
401 | A chave está ausente, errada ou foi revogada. |
402 | A 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. |
404 | Não existe esse app, ou sua chave não pode editá-lo. |
409 | O app ainda não tem código. Crie-o primeiro no Setherion. |
429 | Mais de 600 pequenas ações de IA na última hora nesta conta. |
500 | A resposta do redator não pôde ser usada. Nada é cobrado: os créditos são devolvidos. Tente de novo. |
503 | O limitador está brevemente indisponível, então nada foi executado. Tente de novo em um minuto. |
As frases exatas
| Status | 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. |
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?
