API Applicazioni

Elenca le applicazioni dalla più recente, massimo 500 per pagina. I nomi sono etichette e non devono essere unici; indirizza un’applicazione per ID. next_cursor è la posizione dell’ultima riga restituita mentre ci sono altre righe; passalo come after, con gli stessi filtri, per la pagina successiva. next_cursor è null nell’ultima pagina

Flussi un tar.gz prodotto da CLI direttamente in staging durevole limitato. I metadati sono negli header così l’archivio non è mai codificato base64 o materializzato come JSON dal server.

Il proxy davanti all’API termina una richiesta a cui non ha risposto entro circa 100 s, quindi un archivio grande su un uplink lento fallisce qui; POST /api/applications/uploads invia invece l’archivio direttamente all’archivio oggetti.

Pubblica una nuova versione immutabile di un'applicazione di proprietà usando la stessa pipeline di caricamento tar.gz vincolata. If-Match protegge la revisione dell'applicazione; l'accettazione la incrementa, e la pubblicazione riuscita la incrementa di nuovo quando latest_ready_release cambia. Nome e identità dell'applicazione sono preservati. I pin di rilascio della playlist esistenti non vengono modificati.

Un retry idempotente identico restituisce l’operazione originale anche dopo modifiche di revisione. Il proxy davanti all’API termina una richiesta a cui non ha risposto entro circa 100 s, quindi un archivio grande su un uplink lento fallisce qui; POST /api/applications/{id}/uploads invia invece l’archivio direttamente all’archivio oggetti.

Dichiara un caricamento diretto di un tar.gz prodotto dalla CLI che crea una nuova applicazione. La risposta è un’autorizzazione firmata per esattamente un PUT di oggetto dell’archivio, quindi i byte vanno direttamente all’archivio oggetti e mai attraverso l’API, il cui proxy termina una richiesta a cui non ha risposto entro circa 100 s.

Invia l’archivio con PUT a upload_url, poi conferma con POST /api/applications/uploads/{id}/commit e attendi l’operazione. L’applicazione, la sua versione e l’operazione ricevente esistono da questa risposta, come dopo POST /api/applications. Un caricamento non confermato entro 24 ore fallisce, e un’applicazione che non ha mai pubblicato una versione viene rimossa.

La stessa Idempotency-Key e lo stesso corpo restituiscono lo stesso caricamento con un URL appena firmato. GET /api/capabilities imposta features.application_direct_uploads dove queste route sono servite.

Dichiara un caricamento diretto di una nuova versione immutabile di un’applicazione posseduta, con risposta come POST /api/applications/uploads. If-Match protegge la revisione dell’applicazione come su POST /api/applications/{id}/releases, e l’accettazione la incrementa. Il corpo non porta alcun nome; una versione conserva il nome della sua applicazione. I pin di versione di playlist esistenti non vengono modificati.

Conferma un caricamento diretto di applicazione una volta terminato il suo PUT. Il server verifica l’archivio preparato rispetto alla dichiarazione (la sua dimensione e il checksum SHA-256 che l’archivio oggetti ha preso con il PUT), lo copia nella propria area di preparazione caricamenti e mette in coda la pubblicazione.

Attendi l’Operation restituita con GET /api/operations/{id} finché è succeeded o failed, come dopo POST /api/applications. Un commit prima che il PUT finisca risponde invalid_request e non cambia nulla, quindi può essere inviato di nuovo; byte preparati che differiscono dalla dichiarazione fanno fallire il caricamento. Un commit ripetuto risponde la stessa operazione.

Modifica il nome visualizzato di un’applicazione di proprietà del progetto autenticato. I nomi sono trimmati, contengono da 1 a 120 caratteri Unicode senza controlli e possono ripetersi all’interno di un progetto. Identità dell’app, release, dati K/V e pin di rilascio playlist sono preservati.

Un nome modificato avanza la revisione dell’applicazione ed emette application.updated; lo stesso nome è un’operazione nulla. If-Match protegge opzionalmente la revisione. Un ritentativo idempotente identico restituisce la risposta originale dopo modifiche successive ai metadati.

Tombstone un’applicazione di proprietà del progetto autenticato e tutte le sue release. Il titolare del progetto è autorevole; un id sconosciuto o di altro progetto è not_found. If-Match protegge la revisione dell’applicazione. Un riferimento a manifest live blocca l’eliminazione con application_in_use; non esiste percorso di eliminazione forzata.