API de Aplicaciones

Lista aplicaciones, las más nuevas primero, máximo 500 por página. Los nombres son etiquetas y no necesitan ser únicos; diríjase a una aplicación por ID. next_cursor es la posición de la última fila devuelta mientras queden más filas; páselo como after, con los mismos filtros, para la siguiente página. next_cursor es nulo en la última página.

Transmite un tar.gz producido por CLI directamente a un almacenamiento duradero limitado. Los metadatos se llevan en los encabezados para que el archivo nunca se codifique en base64 ni se materialice como JSON por el servidor.

El proxy frente a la API termina una solicitud que no ha respondido en unos 100 s, por lo que un archivo grande en una subida lenta falla aquí; POST /api/applications/uploads envía el archivo directamente al almacén de objetos.

Publica una nueva versión inmutable de una aplicación propia usando la misma canalización de carga tar.gz vinculada. If-Match protege la revisión de la aplicación; la aceptación la incrementa, y la publicación exitosa la incrementa nuevamente cuando cambia latest_ready_release. Se preservan el nombre y la identidad de la aplicación. No se cambian los pines de lanzamiento de listas de reproducción existentes.

Un reintento idempotente idéntico devuelve la operación original incluso después de cambios en la revisión. El proxy frente a la API termina una solicitud que no ha respondido en unos 100 s, por lo que un archivo grande en una subida lenta falla aquí; POST /api/applications/{id}/uploads envía el archivo directamente al almacén de objetos.

Declara una carga directa de un tar.gz producido por la CLI que crea una nueva aplicación. La respuesta es una autorización firmada para exactamente un PUT de objeto del archivo, por lo que los bytes van directamente al almacén de objetos y nunca pasan por la API, cuyo proxy termina una solicitud que no ha respondido en unos 100 s.

Envíe el archivo con PUT a upload_url, luego confirme con POST /api/applications/uploads/{id}/commit y espere la operación. La aplicación, su versión y la operación receptora existen desde esta respuesta, como después de POST /api/applications. Una carga no confirmada en 24 horas falla, y una aplicación que nunca publicó una versión se elimina.

La misma Idempotency-Key y el mismo cuerpo devuelven la misma carga con una URL recién firmada. GET /api/capabilities establece features.application_direct_uploads donde se sirven estas rutas.

Declara una carga directa de una nueva versión inmutable de una aplicación propia, con respuesta como en POST /api/applications/uploads. If-Match protege la revisión de la aplicación como en POST /api/applications/{id}/releases, y la aceptación la incrementa. El cuerpo no lleva nombre; una versión conserva el nombre de su aplicación. Los pins de versión de listas de reproducción existentes no cambian.

Confirma una carga directa de aplicación una vez finalizado su PUT. El servidor comprueba el archivo preparado frente a la declaración (su tamaño y la suma de verificación SHA-256 que el almacén de objetos tomó con el PUT), lo copia a su propia área de preparación de cargas y pone la publicación en cola.

Espere la Operation devuelta con GET /api/operations/{id} hasta que sea succeeded o failed, como después de POST /api/applications. Una confirmación antes de que finalice el PUT responde invalid_request y no cambia nada, por lo que puede enviarse de nuevo; los bytes preparados que difieren de la declaración hacen fallar la carga. Una confirmación repetida responde la misma operación.

Cambia el nombre visible de una aplicación propiedad del proyecto autenticado. Los nombres se recortan, contienen de 1 a 120 caracteres Unicode sin controles, y pueden repetirse dentro de un proyecto. Se preservan la identidad de la aplicación, versiones, datos K/V y pines de lanzamiento de lista de reproducción.

Un nombre cambiado avanza la revisión de la aplicación y emite application.updated; el mismo nombre no realiza ninguna acción. If-Match protege opcionalmente la revisión. Un reintento idempotente idéntico devuelve la respuesta original tras cambios posteriores en los metadatos.

Elimina una aplicación propiedad del proyecto autenticado y todas sus versiones. El titular del proyecto es la autoridad; un id desconocido o de otro proyecto es not_found. If-Match protege la revisión de la aplicación. Una referencia de manifiesto en vivo bloquea la eliminación con application_in_use; no existe ruta de eliminación forzada.