Lỗi
Mọi lời từ chối đều có cùng một dạng. Hãy xử lý theo code: giá trị này không bao giờ thay đổi. message dành cho người đọc, và có thể thay đổi.
Dạng của một lỗi
{
"error": {
"code": "insufficient_balance",
"message": "This file costs $18.00 USD but your balance is $4.50 USD. Please add funds.",
"request_id": "req_7f3c9a12",
"docs_url": "https://docs.talismanleads.io/errors#insufficient_balance"
}
}Hãy cung cấp request_id nếu bạn liên hệ bộ phận hỗ trợ. Mọi phản hồi cũng mang giá trị này trong header Request-Id.
Tất cả các mã
API không hiểu yêu cầu này: thông báo cho biết lý do. Hãy sửa trước khi gửi lại.
POST /orders cần header Idempotency-Key hợp lệ: tối đa 200 ký tự ASCII không có khoảng trắng.Một dòng trong danh sách không phải là thứ trình kiểm tra nhận. Thông báo có hiển thị ví dụ.
Trình kiểm tra này cần nhiều mục hơn trong mỗi tệp.
Danh sách quá dài: tối đa 100.000 mục trong một yêu cầu, hoặc 10.000.000 mục trong một lần tải lên.
Tệp vượt quá 200 MB.
country bạn gửi không khớp với các số trong danh sách.Một tệp phải chứa các số thuộc một quốc gia. Hãy tách thành mỗi quốc gia một tệp.
upload_id đó không phải của bạn, tệp của nó chưa tải lên xong, hoặc tệp của nó không còn nữa (tệp tải lên chờ đơn hàng trong 24 giờ). Nếu bạn đã đặt đơn hàng từ lần tải lên này và mất phản hồi, hãy lặp lại yêu cầu đó với khóa idempotency ban đầu. Nếu không, hãy tải tệp lên lại và đặt đơn hàng với khóa idempotency mới: không có đơn hàng nào được đặt với khóa cũ.Tệp đã thay đổi sau khi được tính giá. Không có đơn hàng nào được đặt. Hãy tải lên lại và đặt đơn hàng với khóa idempotency mới.
Giá đã quá cũ để sử dụng. Hãy lặp lại yêu cầu với cùng
Idempotency-Key.invalid_key
401Khóa API bị thiếu, sai hoặc không phải của chúng tôi.
revoked_key
401Khóa API này đã bị thu hồi. Hãy dùng khóa API khác.
expired_key
401Khóa API này đã hết hạn. Hãy tạo khóa API mới.
Số dư của bạn không đủ cho đơn hàng này. Hãy nạp tiền, rồi lặp lại đơn hàng với cùng khóa idempotency.
key_blocked
403Khóa API này đã bị chặn. Hãy liên hệ bộ phận hỗ trợ.
Khóa API này chỉ dùng được với các địa chỉ IP khác.
Tài khoản này không thể dùng API. Hãy liên hệ bộ phận hỗ trợ.
Quyền truy cập API của tài khoản này đã bị tắt. Trang web vẫn hoạt động bình thường. Hãy liên hệ bộ phận hỗ trợ.
Khóa API này chỉ đọc, và lệnh gọi này cần khóa API có thể đặt đơn hàng.
Trình kiểm tra này hiện không mở cho tài khoản của bạn. Xem
GET /checkers.Địa chỉ của bạn đã bị chặn. Hãy liên hệ bộ phận hỗ trợ.
not_found
404Không có đơn hàng hoặc endpoint như vậy trên tài khoản này.
Khóa idempotency này đã được dùng với một yêu cầu khác. Hãy dùng khóa idempotency mới cho đơn hàng mới.
Giá không phải là giá bạn dự kiến, hoặc đã thay đổi kể từ lần đầu gửi khóa idempotency này. Không có đơn hàng nào được đặt. Hãy dùng khóa idempotency mới để đặt theo giá mới.
Yêu cầu vượt quá 4 MB. Hãy dùng
POST /uploads cho danh sách lớn.Bạn có quá nhiều tệp tải lên đang chờ (20 tệp hoặc 100 MB), hoặc đã tải lên quá nhiều trong hôm nay (500 lần). Hãy đặt đơn hàng từ một tệp, hoặc thử lại sau: tệp tải lên bị xóa sau 24 giờ.
rate_limited
429Bạn đã vượt giới hạn tốc độ. Hãy chờ số giây trong
Retry-After. Với đơn hàng, hãy lặp lại với cùng khóa idempotency. Xem Giới hạn tốc độ.Bạn có quá nhiều đơn hàng chưa hoàn tất. Hãy chờ số giây trong
Retry-After, rồi lặp lại đơn hàng với cùng khóa idempotency.Đã xảy ra sự cố ở phía chúng tôi. Với
POST /orders, đơn hàng có thể đã được ghi nhận, vì vậy hãy lặp lại yêu cầu với cùng Idempotency-Key: việc này không bao giờ tính phí hai lần. Với các lệnh gọi khác, hãy thử lại, hoặc liên hệ bộ phận hỗ trợ kèm request_id.api_disabled
503API hiện đang tắt. Hãy thử lại sau. Với đơn hàng, hãy lặp lại với cùng khóa idempotency.
API hiện không thể phản hồi. Hãy chờ một phút rồi lặp lại yêu cầu với cùng khóa idempotency.
Chúng tôi không thể xác nhận đơn hàng. Hãy lặp lại yêu cầu với cùng
Idempotency-Key để biết trạng thái thực: việc này không bao giờ tính phí hai lần. Nếu phản hồi này tiếp tục quá vài phút, hãy dừng lại và liên hệ bộ phận hỗ trợ kèm request_id. Đừng tạo khóa idempotency mới.