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.

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

Tarif: 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 charged der 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.

bash
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

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."
  }
}
FeldTypBedeutung
languagestringDer Sprachcode, in dem die Texte geschrieben sind, gelesen von den Bildschirmen der App.
chargednumberDie abgebuchten Credits. 0, wenn das Credit-Konto nicht erreichbar war und der Aufruf durchgelassen wurde.
limitsobjectDie höchste Zeichenzahl pro Feld. Das sind die Grenzen der Stores selbst.
textsobjectDie Texte. Jedes Feld ist immer vorhanden.

Die Felder von texts

FeldWohin es gehörtLimit
nameDer Name der App in beiden Stores30 Zeichen
googleShortGoogle Play, Kurzbeschreibung80 Zeichen
descriptionDie lange Beschreibung, für beide Stores gleich4.000 Zeichen
appleSubtitleApp Store, Untertitel30 Zeichen
appleKeywordsApp Store, Keywords, durch Kommas ohne Leerzeichen getrennt100 Zeichen
applePromoApp Store, Werbetext170 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

StatusWann
401Der Schlüssel fehlt, ist falsch oder wurde widerrufen.
402Das Konto, das die App bezahlt, ist im Tarif Free oder hat keine Credits mehr, oder ein Arbeitsbereich-Limit für Sie wurde erreicht.
404Es gibt diese App nicht, oder Ihr Schlüssel darf sie nicht ändern.
409Die App hat noch keinen Code. Erstellen Sie sie zuerst in Setherion.
429Mehr als 600 kleine KI-Aktionen in der letzten Stunde auf diesem Konto.
500Die Antwort des Schreibers war nicht brauchbar. Es wird nichts berechnet: Die Credits werden zurückgegeben. Versuchen Sie es erneut.
503Die Begrenzung ist kurz nicht verfügbar, daher wurde nichts ausgeführt. Versuchen Sie es in einer Minute erneut.
Die genauen Sätze
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.

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?

Der Community beitreten

Fragen, Ideen und was andere erstellen.