bulksmsapi
Lấy API key

Tham chiếu

Lỗi API và mã lỗi

Xem dạng MarkdownThông số OpenAPI

Lỗi sử dụng mã trạng thái HTTP và luôn có cùng một JSON body. param đặt tên cho trường khi một trường là nguyên nhân. Mọi câu trả lời đều có tiêu đề X-Request-Id: trích dẫn nó trong một ticket hỗ trợ.

400 Bad RequestJSON
{
  "error": {
    "code": "text_too_long",
    "message": "The text is longer than 10 segments (1,530 GSM-7 or 670 UCS-2 characters).",
    "param": "text",
    "doc_url": "https://bulksmsapi.cc/en/docs/errors#text_too_long"
  }
}

Mã

codeHTTPNguyên nhânTiền
invalid_json400Nội dung không phải là đối tượng JSON, hoặc Content-Type không phải là application/json.Sửa nội dung. Không có gì bị tính phí.
invalid_request400Thiếu trường hoặc sai kiểu dữ liệu; tham số chỉ rõ.Sửa trường. Không có gì bị tính phí.
invalid_number400Không có số nào trong yêu cầu đúng định dạng E.164 (+ và 7 đến 15 chữ số).Kiểm tra số. Không có gì bị tính phí.
unsupported_country400 / 404Không có quốc gia nào khớp với số, hoặc GET /v1/pricing/{country} có mã không xác định.Kiểm tra danh sách quốc gia. Không có gì bị tính phí.
text_too_long400Văn bản cần nhiều hơn 10 segment.Rút ngắn văn bản. Không có gì bị tính phí.
too_many_recipients400Hơn 10,000 người nhận trong một yêu cầu.Chia danh sách. Không có gì bị tính phí.
schedule_out_of_range400send_at không phải thời gian hợp lệ (từ 2 phút đến 45 ngày kể từ bây giờ).Chọn thời gian khác. Không có gì bị tính phí.
suppressed400Mọi số trong yêu cầu đều nằm trong danh sách không gửi (Cài đặt trong console).Không có gì được gửi hoặc tính phí.
unauthorized401Thiếu tiêu đề Authorization, sai định dạng hoặc khóa đã bị thu hồi.Gửi khóa live. Không có gì bị tính phí.
top_up_required402Số dư thấp hơn chi phí yêu cầu; thông báo hiển thị cả hai số tiền.Nạp tiền và gửi lại. Không có gì bị tính phí.
not_found404id không tồn tại trong tài khoản này, hoặc endpoint không tồn tại.Kiểm tra id và đường dẫn.
idempotency_conflict409Idempotency-Key đã được sử dụng với nội dung yêu cầu khác trong 24 giờ qua.Sử dụng khóa mới cho yêu cầu mới.
not_cancelable409Chỉ hủy được batch đã lên lịch; batch này đã bắt đầu hoặc kết thúc.Không có gì thay đổi.
rate_limited429Khóa đã thực hiện hơn 600 yêu cầu trong 60 giây qua.Chờ Retry-After giây. Không có gì bị tính phí.
server_error500Có lỗi xảy ra từ phía chúng tôi.Thử lại với cùng Idempotency-Key.

Thử lại

  • Lỗi 4xx (trừ 429) cần thay đổi yêu cầu; gửi lại yêu cầu giống nguyên sẽ nhận cùng lỗi.
  • Với lỗi 429, chờ số giây ghi trong Retry-After.
  • Với lỗi 5xx hoặc timeout mạng, thử lại với cùng Idempotency-Key: nếu yêu cầu đầu được chấp nhận, bạn nhận lại kết quả đó thay vì gửi lần hai.
TrướcAPI Bảng giáTiếp theoGiới hạn truy cập
Lỗi API và mã lỗi | Tài liệu BulkSMSAPI