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.
https://www.setherion.com/api/v1/projects/{id}/store/listingPiano: 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
chargeddella 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.
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
{
"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."
}
}| Campo | Tipo | Significato |
|---|---|---|
language | string | Il codice della lingua in cui sono scritti i testi, letto dalle schermate dell’app. |
charged | number | I crediti presi. 0 quando il registro dei crediti non era raggiungibile e la chiamata è stata lasciata passare. |
limits | object | Il massimo di caratteri che ogni campo può avere. Sono quelli degli store stessi. |
texts | object | I testi. Ogni campo è sempre presente. |
I campi di texts
| Campo | Dove va | Limite |
|---|---|---|
name | Il nome dell’app in entrambi gli store | 30 caratteri |
googleShort | Google Play, descrizione breve | 80 caratteri |
description | La descrizione completa, la stessa per entrambi gli store | 4.000 caratteri |
appleSubtitle | App Store, sottotitolo | 30 caratteri |
appleKeywords | App Store, parole chiave, separate da virgole senza spazi | 100 caratteri |
applePromo | App Store, testo promozionale | 170 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
| Stato | Quando |
|---|---|
401 | La chiave manca, è sbagliata o è stata revocata. |
402 | L’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. |
404 | Non esiste quell’app, oppure la tua chiave non può modificarla. |
409 | L’app non ha ancora codice. Creala prima in Setherion. |
429 | Più di 600 piccole azioni di IA nell’ultima ora su questo account. |
500 | La risposta dello scrittore non era utilizzabile. Non viene addebitato nulla: i crediti vengono restituiti. Riprova. |
503 | Il limitatore è brevemente non disponibile, quindi non è stato eseguito nulla. Riprova tra un minuto. |
Le frasi esatte
| Stato | 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. |
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?
