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.
https://www.setherion.com/api/v1/projects/{id}/store/listingForfait : 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
chargedde 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.
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
{
"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."
}
}| Champ | Type | Signification |
|---|---|---|
language | string | Le code de la langue dans laquelle les textes sont rédigés, lu à partir des écrans de l’application. |
charged | number | Les crédits prélevés. 0 lorsque le registre des crédits était inaccessible et que l’appel a été laissé passer. |
limits | object | Le nombre maximal de caractères de chaque champ. Ce sont les limites des stores eux-mêmes. |
texts | object | Les textes. Chaque champ est toujours présent. |
Les champs de texts
| Champ | Où il va | Limite |
|---|---|---|
name | Le nom de l’application dans les deux stores | 30 caractères |
googleShort | Google Play, description courte | 80 caractères |
description | La description complète, la même pour les deux stores | 4 000 caractères |
appleSubtitle | App Store, sous-titre | 30 caractères |
appleKeywords | App Store, mots-clés, séparés par des virgules sans espaces | 100 caractères |
applePromo | App Store, texte promotionnel | 170 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
| Statut | Quand |
|---|---|
401 | La clé est absente, erronée ou révoquée. |
402 | Le 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. |
404 | Cette application n’existe pas, ou votre clé ne peut pas la modifier. |
409 | L’application n’a pas encore de code. Construisez-la d’abord dans Setherion. |
429 | Plus de 600 petites actions d’IA au cours de la dernière heure sur ce compte. |
500 | La réponse de l’auteur n’a pas pu être utilisée. Rien n’est prélevé : les crédits sont rendus. Réessayez. |
503 | Le limiteur est brièvement indisponible, donc rien n’a été exécuté. Réessayez dans une minute. |
Les phrases exactes
| Statut | 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. |
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 ?
