Passer au contenu principal

​
Tâches asynchrones et interrogation

La plupart des opérations d’écriture sont asynchrones.

​
Ce qui renvoie immédiatement

Ces endpoints acceptent du travail et renvoient des IDs que vous pouvez interroger :
  • POST /projects
  • POST /projects/{projectId}/tasks/stem-separation
  • POST /projects/{projectId}/tasks/lyrics-sync
  • POST /projects/{projectId}/exports

​
Ce qu’il faut interroger

  • Interrogez GET /tasks/{taskId} pour l’état d’exécution et la sortie de la tâche hydratée.
  • Consultez GET /projects/{projectId} pour l’état du projet à long terme.
  • Consultez GET /exports/{exportId} pour des URL de téléchargement d’export à jour.

​
Modèle d’interrogation pratique

  1. Démarrez une mutation et stockez les IDs renvoyés.
  2. Interrogez GET /tasks/{taskId} jusqu’à ce que la tâche atteigne un état terminal.
  3. Relisez la ressource durable par ID au lieu de vous fier à un état en cache obsolète.
  4. Pour les téléchargements, récupérez GET /exports/{exportId} lorsque vous êtes prêt à utiliser l’URL.

​
Pourquoi c’est important

  • Le statut de la tâche est la chronologie d’exécution.
  • L’état du projet est la source de vérité durable.
  • Les URL de téléchargement d’export doivent être considérées comme actualisables plutôt que permanentes.