API Applications

Liste les applications, les plus récentes d’abord, au maximum 500 par page. Les noms sont des étiquettes et ne doivent pas être uniques ; adressez une application par son identifiant. next_cursor est la position de la dernière ligne retournée tant qu’il reste des lignes ; renvoyez-le comme after, avec les mêmes filtres, pour la page suivante. next_cursor est null à la dernière page.

Diffuse un tar.gz produit par CLI directement dans une mise en scène durable bornée. Les métadonnées sont dans les en-têtes, donc l’archive n’est jamais enveloppée en base64 ni matérialisée en JSON par le serveur.

Le proxy devant l’API met fin à une requête à laquelle il n’a pas répondu en environ 100 s, donc une grande archive sur une liaison montante lente échoue ici ; POST /api/applications/uploads envoie plutôt l’archive directement au magasin d’objets.

Publie une nouvelle version immuable d’une application possédée en utilisant la même chaîne de téléversement tar.gz liée. If-Match protège la révision de l’application ; l’acceptation l’incrémente, et la publication réussie l’incrémente à nouveau lorsque latest_ready_release change. Le nom et l’identité de l’application sont conservés. Les épingles de version de liste de lecture existantes ne sont pas modifiées.

Une nouvelle tentative idempotente identique renvoie l’opération originale même après des modifications de révision. Le proxy devant l’API met fin à une requête à laquelle il n’a pas répondu en environ 100 s, donc une grande archive sur une liaison montante lente échoue ici ; POST /api/applications/{id}/uploads envoie plutôt l’archive directement au magasin d’objets.

Déclare un téléversement direct d’un tar.gz produit par la CLI qui crée une nouvelle application. La réponse est une autorisation signée pour exactement un PUT d’objet de l’archive, donc les octets vont directement au magasin d’objets et ne passent jamais par l’API, dont le proxy met fin à une requête à laquelle il n’a pas répondu en environ 100 s.

Envoyez l’archive par PUT à upload_url, puis validez avec POST /api/applications/uploads/{id}/commit et attendez l’opération. L’application, sa version et l’opération de réception existent dès cette réponse, comme après POST /api/applications. Un téléversement non validé dans les 24 heures échoue, et une application qui n’a jamais publié de version est supprimée.

La même Idempotency-Key et le même corps renvoient le même téléversement avec une URL fraîchement signée. GET /api/capabilities définit features.application_direct_uploads là où ces routes sont servies.

Déclare un téléversement direct d’une nouvelle version immuable d’une application possédée, avec une réponse comme pour POST /api/applications/uploads. If-Match protège la révision de l’application comme sur POST /api/applications/{id}/releases, et l’acceptation l’incrémente. Le corps ne porte aucun nom ; une version conserve le nom de son application. Les épinglages de version de listes de lecture existants ne sont pas modifiés.

Valide un téléversement direct d’application une fois son PUT terminé. Le serveur vérifie l’archive préparée par rapport à la déclaration (sa taille et la somme de contrôle SHA-256 que le magasin d’objets a prise avec le PUT), la copie dans sa propre zone de préparation de téléversement et met la publication en file d’attente.

Attendez l’Operation retournée avec GET /api/operations/{id} jusqu’à ce qu’elle soit succeeded ou failed, comme après POST /api/applications. Une validation avant la fin du PUT répond invalid_request et ne change rien, donc elle peut être envoyée à nouveau ; des octets préparés qui diffèrent de la déclaration font échouer le téléversement. Une validation répétée répond la même opération.

Modifie le nom d’affichage d’une application appartenant au projet authentifié. Les noms sont tronqués, contiennent de 1 à 120 caractères Unicode sans contrôles, et peuvent se répéter dans un projet. L’identité de l’application, les versions, les données K/V et les épingles de version de liste de lecture sont conservées.

Un nom modifié fait avancer la révision de l’application et émet application.updated ; le même nom est une opération sans effet. If-Match protège optionnellement la révision. Une nouvelle tentative idempotente identique renvoie la réponse originale après des modifications ultérieures des métadonnées.

Supprime une application appartenant au projet authentifié et toutes ses versions. Le porteur du projet est autorisé ; un identifiant inconnu ou d’un autre projet est not_found. If-Match protège la révision de l’application. Une référence manifeste active bloque la suppression avec application_in_use ; il n’y a pas de suppression forcée.