Danh mục lỗi

Mỗi lỗi là một problem document theo RFC 9457, với type trỏ tới một mục trên trang này và code là tên của mục đó. instance chứa id của yêu cầu; hãy gửi kèm id này khi liên hệ hỗ trợ.

400 invalid_request

Yêu cầu bị sai định dạng: một query parameter không xác định, body không đọc được, một tham số mà endpoint không nhận, hoặc Idempotency-Key sai định dạng. Hãy sửa yêu cầu; đừng thử lại nguyên trạng.

400 invalid_cursor

cursor bị sai định dạng, cũ hơn 24 giờ, hoặc được cấp cho bộ lọc khác; riêng since_cursor của feed kết quả khớp chỉ hết hạn khi cũ hơn thời gian lưu giữ kết quả khớp 30 ngày. Hãy bắt đầu lại danh sách từ trang đầu tiên (feed không có cursor).

401 unauthenticated

Endpoint cần khóa nhưng không có khóa nào được gửi. Header WWW-Authenticate: Bearer realm="api.tuneping.com" được đặt.

401 invalid_api_key

Khóa sai định dạng hoặc không được nhận ra. Hãy kiểm tra xem khóa có bị cắt cụt không và tiền tố tp_live_ / tp_test_.

401 key_revoked

Khóa đã được xoay vòng hoặc bị thu hồi; revoked_at cho biết thời điểm. Hãy dùng khóa hiện tại.

401 token_invalid

Entitlement token (ứng dụng đối tác): token sai định dạng hoặc chữ ký không được nhận ra.

401 token_expired

Entitlement token: token đã hết hạn quá độ lệch thời gian cho phép. Hãy làm mới một lần.

401 token_audience

Entitlement token: audience hoặc issuer của token không phải API này.

403 forbidden_tier

Endpoint hoặc giá trị tham số cần gói cao hơn, ví dụ from của lịch sử cũ hơn độ sâu của gói bạn, hoặc nhiều id theo lô hơn mức gói cho phép. required_tier nêu tên gói, upgrade_url liên kết tới bảng giá.

403 forbidden_scope

Khóa tồn tại nhưng được cấp mà không có phạm vi (scope) mà thao tác này cần (wishlists hoặc webhooks; một danh sách mong muốn gửi qua webhook cũng cần webhooks, được kiểm tra trước gói); required_scope nêu tên phạm vi đó và WWW-Authenticate mang error="insufficient_scope". Hãy dùng khóa có phạm vi đó; khóa mang mọi phạm vi trừ khi được cấp với danh sách hẹp hơn, ví dụ chỉ đọc, và GET /v1/me liệt kê các phạm vi của khóa.

403 entitlement_revoked

Entitlement token xác minh được nhưng giấy phép của nó đã bị thu hồi. Quyền sử dụng đã hết hiệu lực; làm mới cũng không giúp được.

403 livemode_mismatch

Một khóa tp_test_ được dùng cho thao tác chỉ dành cho chế độ live, ví dụ một endpoint webhook nằm ngoài các host thử nghiệm (webhook.site).

404 not_found

Không có đài, bản nhạc, nghệ sĩ hay tài nguyên đó, hoặc chưa quan sát được tiêu đề trực tiếp nào cho đài.

404 station_opted_out

Đài có trong danh bạ nhưng đã yêu cầu không được lập chỉ mục. Tuneping không nói lý do. Hãy coi đài là vĩnh viễn không khả dụng.

406 not_acceptable

Header Accept không liệt kê media type nào được hỗ trợ. Body vẫn là application/problem+json.

409 conflict

Tài nguyên trùng lặp, ví dụ một endpoint webhook thứ hai có cùng URL.

409 idempotency_in_progress

Một yêu cầu có cùng Idempotency-Key vẫn đang chạy. Hãy thử lại sau Retry-After giây để nhận phản hồi của nó.

410 endpoint_sunset

Endpoint đã bị ngừng sau ngày Sunset đã thông báo; header Link trỏ tới mục tương ứng trong nhật ký thay đổi.

413 payload_too_large

Body của yêu cầu giới hạn ở 64 KiB; PUT /v1/wishlists nhận tới 1 MiB.

422 validation_failed

Một hoặc nhiều tham số có giá trị không hợp lệ. errors[] liệt kê field, code và một message dễ đọc cho từng tham số.

422 idempotency_key_reused

Idempotency-Key đã được dùng trong 24 giờ qua cho một yêu cầu khác (method, đường dẫn, query hoặc body). Hãy gửi Idempotency-Key mới cho yêu cầu mới.

429 rate_limited

Token bucket theo giây đã cạn. Hãy chờ Retry-After giây; header RateLimit nêu tên chính sách đã bị dùng hết.

429 too_many_connections

Khóa đã mở số luồng sự kiện tối đa mà gói cho phép (Developer 1, Pro 5, Business 20, Tapelark 1 cho mỗi thiết bị). Hãy đóng bớt một luồng trước.

429 quota_exceeded

Hạn mức ngày hoặc tháng đã dùng hết. Retry-After và quota_resets_at cho biết khi nào hạn mức được đặt lại; upgrade_url liên kết tới bảng giá.

500 internal_error

Có lỗi ở phía chúng tôi. Hãy thử lại với backoff và gửi cho chúng tôi id của yêu cầu nếu lỗi còn tiếp diễn.

503 unavailable

Cơ sở dữ liệu không khả dụng hoặc dịch vụ đang bảo trì, hoặc một yêu cầu có Idempotency-Key vẫn đang chạy sau 20 giây và đã bị hủy mà không thay đổi gì. Hãy thử lại sau Retry-After giây, giá trị này cũng có trong retry_after_seconds (1 với yêu cầu bị hủy; hãy thử lại với cùng Idempotency-Key).

Quay lại tài liệu tham khảo API