Saltar para o conteúdo principal

​
Jobs assíncronos e polling

A maioria das operações de escrita é assíncrona.

​
O que retorna imediatamente

Esses endpoints aceitam o trabalho e retornam IDs que você pode consultar por polling:
  • POST /projects
  • POST /projects/{projectId}/tasks/stem-separation
  • POST /projects/{projectId}/tasks/lyrics-sync
  • POST /projects/{projectId}/exports

​
O que consultar por polling

  • Faça polling em GET /tasks/{taskId} para obter o status de execução e a saída da tarefa com dados completos.
  • Leia GET /projects/{projectId} para obter o estado do projeto de longa duração.
  • Leia GET /exports/{exportId} para obter URLs novas para download do export.

​
Modelo prático de polling

  1. Inicie uma mutação e armazene os IDs retornados.
  2. Faça polling em GET /tasks/{taskId} até a tarefa atingir um estado terminal.
  3. Releia o recurso durável pelo ID em vez de confiar em estado em cache desatualizado.
  4. Para downloads, busque GET /exports/{exportId} quando você estiver pronto para usar a URL.

​
Por que isso importa

  • O status da tarefa é a linha do tempo da execução.
  • O estado do projeto é a fonte de verdade durável.
  • As URLs de download do export devem ser tratadas como atualizáveis, e não como permanentes.