Saltar al contenido principal

​
Trabajos asíncronos y sondeo

La mayoría de las operaciones de escritura son asíncronas.

​
Qué devuelve inmediatamente

Estos endpoints aceptan trabajo y devuelven IDs que puedes sondear:
  • POST /projects
  • POST /projects/{projectId}/tasks/stem-separation
  • POST /projects/{projectId}/tasks/lyrics-sync
  • POST /projects/{projectId}/exports

​
Qué sondear

  • Sondea GET /tasks/{taskId} para conocer el estado de ejecución y la salida de la tarea con datos hidratados.
  • Consulta GET /projects/{projectId} para el estado del proyecto de larga duración.
  • Consulta GET /exports/{exportId} para obtener URLs de descarga de exportación recientes.

​
Modelo práctico de sondeo

  1. Inicia una mutación y guarda los IDs devueltos.
  2. Sondea GET /tasks/{taskId} hasta que la tarea alcance un estado terminal.
  3. Vuelve a leer el recurso duradero por ID en lugar de confiar en estado obsoleto en caché.
  4. Para descargas, consulta GET /exports/{exportId} cuando estés listo para usar la URL.

​
Por qué esto importa

  • El estado de la tarea es la línea de tiempo de ejecución.
  • El estado del proyecto es la fuente de verdad duradera.
  • Las URLs de descarga de exportación deben tratarse como actualizables en lugar de permanentes.