Xử lý lỗi

Đọc trạng thái HTTP cùng nội dung phản hồi. Các trường lỗi khác nhau theo endpoint; xem hợp đồng chính xác trong tài liệu API.

Khi hết thời gian chờ hoặc gặp lỗi 5xx tạm thời, hãy tra cứu ID nội dung hoặc tác vụ đã nhận trước. Khi thử lại cùng thao tác, giữ nguyên nội dung và idempotency_key, giới hạn số lần và tăng thời gian chờ. HTTP 202 là tiếp nhận, không phải xuất bản thành công.
Với 409 idempotency_conflict, đối chiếu yêu cầu gốc và kết quả. Không tự động tạo khóa mới. Chỉ dùng khóa mới cho thao tác mới có chủ đích sau khi xác minh thao tác trước.
Sửa dữ liệu, xác thực hoặc quyền trước khi thử lại. Với 429, kiểm tra lỗi và Retry-After nếu có: hết hạn mức có thể cần đặt lại hạn mức hoặc đổi gói thay vì chờ ngắn.

{
  "error": "insufficient_scope",
  "message": "publishing:write scope is required for this API request."
}