Endpoints

Rédiger la fiche du store

Les textes de la fiche du store pour Google Play et l’App Store, rédigés à partir de ce que disent les écrans de l’application.

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

Forfait : Pro and up

Rédige d’un seul coup les textes de la fiche de l’application pour les deux stores : le nom, les descriptions courte et complète de Google Play, ainsi que le sous-titre, les mots-clés et le texte promotionnel de l’App Store. C’est le même travail que le bouton Write it de la fenêtre « Publish to app stores », avec la même règle de forfait, le même prix et le même payeur.

Les textes viennent de ce que disent les écrans de l’application, dans la langue de ces écrans. Il est demandé à l’auteur de ne jamais inventer une fonctionnalité, un prix, une note ou un nombre d’utilisateurs, et de ne nommer ni les stores ni l’outil avec lequel l’application a été créée.

Vous devez pouvoir modifier l’application, car cet appel dépense ses crédits. Rien n’est enregistré : montrez les textes au propriétaire pour qu’il les copie dans Play Console et App Store Connect.

Coût et forfait

  • Crédits. Quelques-uns, prélevés avant le travail, sur le compte qui paie l’application. Le champ charged de la réponse indique combien ont été pris. Si aucune fiche exploitable n’a été produite, ils sont rendus.
  • Forfait. Pro ou Business, du compte qui paie l’application. Sur Free, l’appel répond 402.
  • Rythme. Le même plafond horaire que les autres petites actions d’IA de l’éditeur, 600 par heure et par compte. Une personne ne l’atteint jamais.

Requête

Aucun corps n’est nécessaire.

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

Elle prend jusqu’à environ deux minutes. Réglez le délai d’attente de votre client à 2 minutes au moins.

Réponse

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."
  }
}
ChampTypeSignification
languagestringLe code de la langue dans laquelle les textes sont rédigés, lu à partir des écrans de l’application.
chargednumberLes crédits prélevés. 0 lorsque le registre des crédits était inaccessible et que l’appel a été laissé passer.
limitsobjectLe nombre maximal de caractères de chaque champ. Ce sont les limites des stores eux-mêmes.
textsobjectLes textes. Chaque champ est toujours présent.

Les champs de texts

ChampOù il vaLimite
nameLe nom de l’application dans les deux stores30 caractères
googleShortGoogle Play, description courte80 caractères
descriptionLa description complète, la même pour les deux stores4 000 caractères
appleSubtitleApp Store, sous-titre30 caractères
appleKeywordsApp Store, mots-clés, séparés par des virgules sans espaces100 caractères
applePromoApp Store, texte promotionnel170 caractères

Chaque champ est coupé à sa limite, à la fin d’un mot entier, parce qu’une console de store refuse un champ qui dépasse sa limite et qu’un modèle compte mal les caractères. Les mots-clés sont nettoyés aussi : chacun apparaît une seule fois, et aucun ne répète un mot du nom. La description complète est du texte brut, avec les principales actions possibles une par ligne, chacune commençant par •.

Erreurs

StatutQuand
401La clé est absente, erronée ou révoquée.
402Le compte qui paie l’application est sur Free, n’a plus de crédits, ou une limite d’espace de travail qui vous concerne a été atteinte.
404Cette application n’existe pas, ou votre clé ne peut pas la modifier.
409L’application n’a pas encore de code. Construisez-la d’abord dans Setherion.
429Plus de 600 petites actions d’IA au cours de la dernière heure sur ce compte.
500La réponse de l’auteur n’a pas pu être utilisée. Rien n’est prélevé : les crédits sont rendus. Réessayez.
503Le limiteur est brièvement indisponible, donc rien n’a été exécuté. Réessayez dans une minute.
Les phrases exactes
Statuterror
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.

Le premier 402 concerne Free. Le nombre dans le deuxième est le prix et votre solde ; sur l’application de quelqu’un d’autre, vous obtenez la troisième phrase à la place, qui ne nomme jamais son solde. Les lignes 500 sont des exemples : la phrase indique ce qui s’est mal passé, et les crédits sont rendus.

Cette page vous a-t-elle été utile ?

Rejoindre la communauté

Questions, idées et ce que construisent les autres.