API de Aplicativos

Lista aplicativos do mais novo para o mais antigo, no máximo 500 por página. Nomes são rótulos e não precisam ser únicos; enderece um aplicativo pelo ID. next_cursor é a posição da última linha retornada enquanto houver mais linhas; passe-o de volta como after, com os mesmos filtros, para a próxima página. next_cursor é nulo na última página.

Transmite um tar.gz produzido por CLI diretamente para staging durável limitado. Metadados são carregados nos cabeçalhos para que o arquivo nunca seja codificado em base64 ou materializado como JSON pelo servidor.

O proxy na frente da API encerra uma solicitação que não respondeu em cerca de 100 s, portanto um arquivo grande em um uplink lento falha aqui; POST /api/applications/uploads envia o arquivo diretamente para o armazenamento de objetos.

Publica uma nova versão imutável de um aplicativo próprio usando o mesmo pipeline de upload tar.gz vinculado. If-Match protege a revisão do aplicativo; a aceitação a incrementa, e a publicação bem-sucedida a incrementa novamente quando latest_ready_release muda. Nome e identidade do aplicativo são preservados. Os pins de lançamento da playlist existentes não são alterados.

Uma repetição idempotente idêntica retorna a operação original mesmo após alterações de revisão. O proxy na frente da API encerra uma solicitação que não respondeu em cerca de 100 s, portanto um arquivo grande em um uplink lento falha aqui; POST /api/applications/{id}/uploads envia o arquivo diretamente para o armazenamento de objetos.

Declara um upload direto de um tar.gz produzido pela CLI que cria um novo aplicativo. A resposta é uma autorização assinada para exatamente um PUT de objeto do arquivo, portanto os bytes vão diretamente para o armazenamento de objetos e nunca pela API, cujo proxy encerra uma solicitação que não respondeu em cerca de 100 s.

Envie o arquivo com PUT para upload_url, depois confirme com POST /api/applications/uploads/{id}/commit e aguarde a operação. O aplicativo, sua versão e a operação receptora existem a partir desta resposta, como após POST /api/applications. Um upload não confirmado em 24 horas falha, e um aplicativo que nunca publicou uma versão é removido.

A mesma Idempotency-Key e o mesmo corpo retornam o mesmo upload com uma URL recém-assinada. GET /api/capabilities define features.application_direct_uploads onde essas rotas são servidas.

Declara um upload direto de uma nova versão imutável de um aplicativo próprio, respondido como POST /api/applications/uploads. If-Match protege a revisão do aplicativo como em POST /api/applications/{id}/releases, e a aceitação a incrementa. O corpo não carrega nome; uma versão mantém o nome do seu aplicativo. Pins de versão de playlists existentes não são alterados.

Confirma um upload direto de aplicativo assim que seu PUT termina. O servidor verifica o arquivo preparado em relação à declaração (seu tamanho e o checksum SHA-256 que o armazenamento de objetos obteve com o PUT), copia para sua própria área de preparação de upload e coloca a publicação na fila.

Aguarde a Operation retornada com GET /api/operations/{id} até que esteja succeeded ou failed, como após POST /api/applications. Um commit antes do término do PUT responde invalid_request e não altera nada, portanto pode ser enviado novamente; bytes preparados que diferem da declaração fazem o upload falhar. Um commit repetido responde a mesma operação.

Altera o nome exibido de um aplicativo pertencente ao projeto autenticado. Os nomes são aparados, contêm de 1 a 120 caracteres Unicode sem controles, e podem se repetir dentro de um projeto. Identidade do aplicativo, versões, dados K/V e pins de lançamento de playlist são preservados.

Um nome alterado avança a revisão da aplicação e emite application.updated; o mesmo nome é uma operação sem efeito. If-Match opcionalmente protege a revisão. Uma nova tentativa idempotente idêntica retorna a resposta original após alterações subsequentes nos metadados.

Marca para exclusão um aplicativo pertencente ao projeto autenticado e todas as suas versões. O portador do projeto é autoritário; um id desconhecido ou de outro projeto é not_found. If-Match protege a revisão do aplicativo. Uma referência de manifesto ativo bloqueia a exclusão com application_in_use; não há caminho para exclusão forçada.