> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Async jobs and polling

> Hiểu về các thao tác ghi dựa trên tác vụ, các trạng thái tác vụ kết thúc, và những tài nguyên nào lưu giữ trạng thái bền vững.

# 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.