Endpunkte
Die Store-Seite schreiben
Die Texte der Store-Seite für Google Play und den App Store, geschrieben nach dem, was die Bildschirme der App sagen.
https://www.setherion.com/api/v1/projects/{id}/store/listingTarif: Pro and up
Schreibt die Texte der Store-Seite der App in einem Zug, für beide Stores: den Namen, die kurze und die lange Beschreibung von Google Play sowie den Untertitel, die Keywords und den Werbetext des App Store. Es ist dieselbe Arbeit wie die Schaltfläche Write it im Fenster „Publish to app stores“, mit derselben Tarifregel, demselben Preis und derselben zahlenden Person.
Die Texte entstehen aus dem, was die Bildschirme der App sagen, in der Sprache dieser Bildschirme. Dem Schreiber wird gesagt, er solle nie ein Feature, einen Preis, eine Bewertung oder eine Nutzerzahl erfinden und weder die Stores noch das Werkzeug nennen, mit dem die App erstellt wurde.
Sie müssen die App ändern dürfen, weil dabei ihre Credits verbraucht werden. Nichts wird gespeichert: Zeigen Sie dem Inhaber die Texte, damit er sie in die Play Console und App Store Connect kopiert.
Kosten und Tarif
- Credits. Einige wenige, vor der Arbeit abgebucht, vom Konto, das die App bezahlt. Das Feld
chargedder Antwort sagt, wie viele abgebucht wurden. Wenn keine brauchbare Seite herauskam, werden sie zurückgegeben. - Tarif. Pro oder Business, des Kontos, das die App bezahlt. Im Tarif Free antwortet der Aufruf mit
402. - Tempo. Dieselbe Stundengrenze wie bei den anderen kleinen KI-Aktionen des Editors, 600 pro Stunde und Konto. Eine Person erreicht sie nie.
Anfrage
Es wird kein Body benötigt.
curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store/listing \
-H "Authorization: Bearer $SETHERION_API_KEY"Es dauert bis zu etwa zwei Minuten. Stellen Sie das Timeout Ihres Clients auf mindestens 2 Minuten ein.
Antwort
{
"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."
}
}| Feld | Typ | Bedeutung |
|---|---|---|
language | string | Der Sprachcode, in dem die Texte geschrieben sind, gelesen von den Bildschirmen der App. |
charged | number | Die abgebuchten Credits. 0, wenn das Credit-Konto nicht erreichbar war und der Aufruf durchgelassen wurde. |
limits | object | Die höchste Zeichenzahl pro Feld. Das sind die Grenzen der Stores selbst. |
texts | object | Die Texte. Jedes Feld ist immer vorhanden. |
Die Felder von texts
| Feld | Wohin es gehört | Limit |
|---|---|---|
name | Der Name der App in beiden Stores | 30 Zeichen |
googleShort | Google Play, Kurzbeschreibung | 80 Zeichen |
description | Die lange Beschreibung, für beide Stores gleich | 4.000 Zeichen |
appleSubtitle | App Store, Untertitel | 30 Zeichen |
appleKeywords | App Store, Keywords, durch Kommas ohne Leerzeichen getrennt | 100 Zeichen |
applePromo | App Store, Werbetext | 170 Zeichen |
Jedes Feld wird an einer ganzen Wortgrenze auf sein Limit gekürzt, weil eine Store-Konsole ein Feld über dem Limit ablehnt und ein Modell Zeichen schlecht zählt. Auch die Keywords werden bereinigt: Jedes kommt nur einmal vor, und keines wiederholt ein Wort des Namens. Die lange Beschreibung ist reiner Text, mit den wichtigsten Dingen, die Personen tun können, eines pro Zeile, jedes beginnt mit •.
Fehler
| Status | Wann |
|---|---|
401 | Der Schlüssel fehlt, ist falsch oder wurde widerrufen. |
402 | Das Konto, das die App bezahlt, ist im Tarif Free oder hat keine Credits mehr, oder ein Arbeitsbereich-Limit für Sie wurde erreicht. |
404 | Es gibt diese App nicht, oder Ihr Schlüssel darf sie nicht ändern. |
409 | Die App hat noch keinen Code. Erstellen Sie sie zuerst in Setherion. |
429 | Mehr als 600 kleine KI-Aktionen in der letzten Stunde auf diesem Konto. |
500 | Die Antwort des Schreibers war nicht brauchbar. Es wird nichts berechnet: Die Credits werden zurückgegeben. Versuchen Sie es erneut. |
503 | Die Begrenzung ist kurz nicht verfügbar, daher wurde nichts ausgeführt. Versuchen Sie es in einer Minute erneut. |
Die genauen Sätze
| 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. |
Das erste 402 gilt für Free. Die Zahl im zweiten ist der Preis und Ihr Guthaben; bei der App einer anderen Person erhalten Sie stattdessen den dritten Satz, der ihr Guthaben nie nennt. Die 500-Zeilen sind Beispiele: Der Satz nennt, was schiefgegangen ist, und die Credits werden zurückgegeben.
War diese Seite hilfreich?
