Endpoint
Preparazione per gli store
Cosa serve ancora a un’app per Google Play e l’App Store, e i passaggi in ordine.
https://www.setherion.com/api/v1/projects/{id}/storePiano: Ogni piano
La finestra “Publish to app stores” dell’editor, detta in dati: cosa è pronto per gli store e, con way, i passaggi per Android e iPhone in ordine. Legge il codice salvato dell’app con gli stessi strumenti della finestra, quindi non è mai in disaccordo con essa.
È gratis e non usa crediti. Basta l’accesso come viewer. Per le finestre e la guida completa, vedi Pubblicare sugli store di app.
Richiesta
Senza way, per confrontare prima le due strade:
curl https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store \
-H "Authorization: Bearer $SETHERION_API_KEY"Con way, per i passaggi:
curl "https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store?way=easy" \
-H "Authorization: Bearer $SETHERION_API_KEY"| Parametro | Significato |
|---|---|
way | Facoltativo. easy o native. easy impacchetta il sito web pubblicato in pacchetti per gli store con PWA Builder, senza codice. native è l’intera app come progetto per il telefono che l’owner crea su un computer, necessario per pubblicità e acquisti in-app. Qualsiasi altro valore risponde 400. |
L’app deve avere del codice. Se è pubblicata, la chiamata chiede anche all’app online la sua icona per gli store (/icon-512.png), aspettando al massimo 5 secondi.
Risposta senza way
{
"ok": true,
"app": { "name": "Coffee shop", "url": "https://coffee-shop.setherion.app" },
"ready": [
{
"item": "Published on the web",
"state": "ok",
"note": "https://coffee-shop.setherion.app"
},
{
"item": "Store icon",
"state": "ok",
"note": "PNG in every size the stores ask for, made when the app is published."
},
{
"item": "Privacy policy page",
"state": "missing",
"note": "Both stores ask for a link to one, and none was found in this app.",
"fix": "Add a Privacy Policy page at /privacy, linked from the footer and from the sign-up screen. Say what the app keeps (the account email and what people enter), why, for how long, that nothing is sold, and how to ask for an account and its data to be deleted. Leave the owner's contact email as a placeholder to fill in."
}
],
"ways": {
"easy": "Easy, no code: PWA Builder wraps the published website into store packages. About 2 steps in Setherion, the rest in the stores. Android is done from any computer; iPhone needs a Mac with Xcode.",
"native": "Native, for developers: the whole app as a phone project (Capacitor). Needed for ads and in-app purchases. Built on the owner's computer (Android Studio; a Mac with Xcode for iPhone), or in the cloud by GitHub when pushed to GitHub: no Android Studio and no Mac."
},
"onlyInSetherion": "In Setherion: open the app, Publish, then \"Publish to app stores\". Only there: dropping PWA Builder's ZIP, adding Google Play's key, downloading the phone project or pushing it to GitHub, the store screenshots (every size both stores ask for, free), and the store guidelines check. The window ticks the steps it can see, and keeps the owner's own ticks."
}| Campo | Tipo | Significato |
|---|---|---|
app | object | Il name dell’app, e il suo url oppure null quando non è pubblicata. |
ready | list | Cosa è pronto e cosa manca. Vedi sotto. |
ways | object | Una frase per ciascuna strada, easy e native. |
onlyInSetherion | string | Cosa sa fare solo la finestra di Setherion, così un programma sa dove finisce la sua portata. |
L’elenco ready
Ogni voce ha item, state e note, e a volte fix.
| Campo | Significato |
|---|---|
item | Cosa viene controllato. |
state | ok, missing, oppure unknown quando non è stato possibile controllarlo in questo momento. |
note | Una frase che dice perché. |
fix | Solo su una voce missing che l’editor può aggiungere. Il testo da inviare a Modificare un’app come prompt, una volta che l’owner è d’accordo, perché una modifica spende crediti. |
Le voci che possono comparire
- Published on the web.
okquando l’app ha un indirizzo.missingquando non lo ha: la strada Easy impacchetta l’indirizzo pubblicato, quindi pubblica prima. La strada Native funziona anche senza. - Store icon. Elencata solo dopo che l’app è pubblicata.
okquando l’app online serve l’icona PNG,missingquando non lo fa (pubblica di nuovo; un’app sul proprio dominio per ora ha solo l’icona SVG),unknownquando non è stato possibile controllare l’app online. - Delete account button. Elencata solo quando le persone possono registrarsi all’app. Apple rifiuta un’app così senza di essa.
missingha unfix. - Privacy policy page. Entrambi gli store ne chiedono un link.
missingha unfix.
Risposta con way
Gli stessi campi, e i passaggi per la strada che hai chiesto:
{
"ok": true,
"app": { "name": "Coffee shop", "url": "https://coffee-shop.setherion.app" },
"ready": [ "... as above ..." ],
"ways": { "easy": "...", "native": "..." },
"way": "easy",
"android": [
{
"step": 1,
"title": "Make the Android package",
"meta": "PWA Builder, about 2 minutes",
"detail": "Open PWA Builder with the app's address filled in. Choose Package for stores, then Android, and download the ZIP.",
"link": "https://www.pwabuilder.com/reportcard?site=https%3A%2F%2Fcoffee-shop.setherion.app"
},
{
"step": 2,
"title": "Link the app to your site",
"meta": "So it opens without a browser's address bar",
"detail": "In Setherion: open the app, Publish, then \"Publish to app stores\", Easy, Android, this step: drop the ZIP from PWA Builder there. ...",
"done": false
}
],
"iphone": [ "... five steps, numbered the same way ..." ],
"iphoneNotes": [
"A Mac is needed. The Easy way builds the iPhone app on a Mac with Xcode. The Native way can build it on GitHub's Mac computers instead. Make sure you have one of the two before you pay Apple's $99 a year.",
"To Apple this looks like a website. Nobody signs in, nothing is saved, and Apple turns down apps that are only a website (guideline 4.2). Sign-in, saved data and features people come back to make it an app. Run the store guidelines check on the first page before you send it."
],
"onlyInSetherion": "..."
}(Abbreviato qui: la risposta vera ha ogni passaggio per intero.)
| Campo | Tipo | Significato |
|---|---|---|
way | string | La strada richiesta, easy o native. |
android | list | I passaggi per Android, in ordine. |
iphone | list | I passaggi per iPhone, in ordine. |
iphoneNotes | list of strings | Per cosa Apple può rifiutare l’app, ciascuno una frase, con il titolo dove la finestra lo mette. |
Ogni passaggio ha:
| Campo | Tipo | Significato |
|---|---|---|
step | number | Il suo posto nell’elenco, da 1. |
title | string | Il nome del passaggio, quello che mostra la finestra. |
meta | string | Una breve riga: quanto richiede, di cosa ha bisogno o quanto costa. |
detail | string | Cosa fare. Può contenere più righe, come i comandi da eseguire. |
link | string | Dove farlo, quando c’è un posto. Omesso altrimenti. |
done | boolean | Solo sui passaggi che Setherion riesce a vedere da sé nella strada Easy per Android: il collegamento al tuo sito e la chiave di Google Play. Omesso quando non può dirlo. |
I passaggi di ogni elenco
Easy, Android: crea il pacchetto Android, collega l’app al tuo sito, apri un account sviluppatore Google Play, caricalo e provalo, aggiungi la chiave di Google Play, compila la scheda dello store e pubblica la versione.
Easy, iPhone: apri un account sviluppatore Apple, crea il pacchetto per iPhone, compilalo e caricalo, provalo sul tuo iPhone, compila la scheda dello store e invialo in revisione.
Native, Android: scarica il progetto, compilalo, firmalo, caricalo e provalo, pubblica la versione.
Native, iPhone: scarica il progetto, compilalo, firmalo e caricalo, provalo sul tuo iPhone, compila la scheda dello store e invialo in revisione.
Nella strada Native i comandi in detail includono il passaggio di configurazione in più quando l’app mostra pubblicità o vende cose, e le note su pubblicità e acquisti in-app per i moduli degli store.
Errori
| Stato | Quando |
|---|---|
400 | way è qualcosa di diverso da easy o native. |
401 | La chiave manca, è sbagliata o è stata revocata. |
404 | Non esiste un’app del genere, oppure la tua chiave non può aprirla. |
409 | L’app non ha ancora codice. Creala prima in Setherion. |
Le frasi esatte
| Stato | error |
|---|---|
400 | way is "easy" or "native". |
404 | No such app on this account. |
409 | This app has no code yet. Build it in Setherion first. |
Questa pagina ti è stata utile?
