Vai al contenuto principale

​
Job asincroni e polling

La maggior parte delle operazioni di scrittura è asincrona.

​
Cosa viene restituito immediatamente

Questi endpoint accettano il lavoro e restituiscono ID che puoi interrogare tramite polling:
  • POST /projects
  • POST /projects/{projectId}/tasks/stem-separation
  • POST /projects/{projectId}/tasks/lyrics-sync
  • POST /projects/{projectId}/exports

​
Cosa interrogare

  • Esegui il polling su GET /tasks/{taskId} per lo stato di esecuzione e l’output del task idratato.
  • Leggi GET /projects/{projectId} per lo stato del progetto a lunga durata.
  • Leggi GET /exports/{exportId} per URL di download dell’export aggiornati.

​
Modello pratico di polling

  1. Avvia una mutazione e salva gli ID restituiti.
  2. Esegui il polling su GET /tasks/{taskId} finché il task non raggiunge uno stato terminale.
  3. Rileggi la risorsa durevole tramite ID invece di fidarti di uno stato obsoleto in cache.
  4. Per i download, recupera GET /exports/{exportId} quando sei pronto a usare l’URL.

​
Perché è importante

  • Lo stato del task è la timeline di esecuzione.
  • Lo stato del progetto è la fonte di verità durevole.
  • Gli URL di download dell’export dovrebbero essere considerati aggiornabili, non permanenti.