Endpoint

Scrivere la scheda dello store

I testi della scheda dello store per Google Play e l’App Store, scritti a partire da ciò che dicono le schermate dell’app.

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

Piano: Pro and up

Scrive in un colpo solo i testi della scheda dello store dell’app, per entrambi gli store: il nome, le descrizioni breve e completa di Google Play, e il sottotitolo, le parole chiave e il testo promozionale dell’App Store. È lo stesso lavoro del pulsante Write it nella finestra “Publish to app stores”, con la stessa regola del piano, lo stesso prezzo e lo stesso pagante.

I testi nascono da ciò che dicono le schermate dell’app, nella lingua di quelle schermate. Allo scrittore viene detto di non inventare mai una funzione, un prezzo, una valutazione o un numero di utenti, e di non nominare né gli store né lo strumento con cui l’app è stata creata.

Devi poter modificare l’app, perché questa operazione ne spende i crediti. Non viene salvato nulla: mostra al proprietario i testi da copiare in Play Console e App Store Connect.

Costo e piano

  • Crediti. Pochi, addebitati prima del lavoro, all’account che paga per l’app. Il campo charged della risposta dice quanti sono stati presi. Se non è uscita una scheda utilizzabile, vengono restituiti.
  • Piano. Pro o Business, dell’account che paga per l’app. Con Free la chiamata risponde 402.
  • Ritmo. Lo stesso tetto orario delle altre piccole azioni di IA dell’editor, 600 all’ora per account. Una persona non lo raggiunge mai.

Richiesta

Non serve nessun body.

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

Richiede fino a circa due minuti. Imposta il timeout del tuo client ad almeno 2 minuti.

Risposta

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."
  }
}
CampoTipoSignificato
languagestringIl codice della lingua in cui sono scritti i testi, letto dalle schermate dell’app.
chargednumberI crediti presi. 0 quando il registro dei crediti non era raggiungibile e la chiamata è stata lasciata passare.
limitsobjectIl massimo di caratteri che ogni campo può avere. Sono quelli degli store stessi.
textsobjectI testi. Ogni campo è sempre presente.

I campi di texts

CampoDove vaLimite
nameIl nome dell’app in entrambi gli store30 caratteri
googleShortGoogle Play, descrizione breve80 caratteri
descriptionLa descrizione completa, la stessa per entrambi gli store4.000 caratteri
appleSubtitleApp Store, sottotitolo30 caratteri
appleKeywordsApp Store, parole chiave, separate da virgole senza spazi100 caratteri
applePromoApp Store, testo promozionale170 caratteri

Ogni campo viene tagliato al suo limite a una parola intera, perché la console di uno store rifiuta un campo oltre il limite e un modello conta male i caratteri. Anche le parole chiave vengono ripulite: ciascuna compare una sola volta, e nessuna ripete una parola del nome. La descrizione completa è testo semplice, con le cose principali che le persone possono fare una per riga, ognuna che comincia con •.

Errori

StatoQuando
401La chiave manca, è sbagliata o è stata revocata.
402L’account che paga per l’app è su Free, oppure non ha più crediti, oppure è stato raggiunto un limite dello spazio di lavoro su di te.
404Non esiste quell’app, oppure la tua chiave non può modificarla.
409L’app non ha ancora codice. Creala prima in Setherion.
429Più di 600 piccole azioni di IA nell’ultima ora su questo account.
500La risposta dello scrittore non era utilizzabile. Non viene addebitato nulla: i crediti vengono restituiti. Riprova.
503Il limitatore è brevemente non disponibile, quindi non è stato eseguito nulla. Riprova tra un minuto.
Le frasi esatte
Statoerror
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.

Il primo 402 è per Free. Il numero nel secondo è il prezzo e il tuo saldo; sull’app di qualcun altro ottieni invece la terza frase, che non nomina mai il suo saldo. Le righe 500 sono esempi: la frase nomina cosa è andato storto, e i crediti vengono restituiti.

Questa pagina ti è stata utile?

Unisciti alla community

Domande, idee e cosa stanno creando gli altri.