Chuyển đến nội dung chính

​
Job bất đồng bộ và polling

Hầu hết các thao tác ghi đều là bất đồng bộ.

​
Những gì trả về ngay lập tức

Các endpoint này nhận công việc và trả về các ID mà bạn có thể poll:
  • POST /projects
  • POST /projects/{projectId}/tasks/stem-separation
  • POST /projects/{projectId}/tasks/lyrics-sync
  • POST /projects/{projectId}/exports

​
Những gì cần poll

  • Poll GET /tasks/{taskId} để theo dõi trạng thái thực thi và đầu ra tác vụ đã được hydrate.
  • Đọc GET /projects/{projectId} để lấy trạng thái dự án dài hạn.
  • Đọc GET /exports/{exportId} để lấy các URL tải xuống export mới.

​
Mô hình polling thực tế

  1. Bắt đầu một thao tác mutation và lưu các ID được trả về.
  2. Poll GET /tasks/{taskId} cho đến khi tác vụ đạt tới trạng thái kết thúc.
  3. Đọc lại tài nguyên bền vững theo ID thay vì tin vào trạng thái cache cũ.
  4. Với việc tải xuống, gọi GET /exports/{exportId} khi bạn sẵn sàng sử dụng URL.

​
Vì sao điều này quan trọng

  • Trạng thái tác vụ là dòng thời gian thực thi.
  • Trạng thái dự án là nguồn chân lý bền vững.
  • Các URL tải xuống export nên được xem là có thể làm mới thay vì vĩnh viễn.