Tài liệu API

Tích hợp kiểm tra số điện thoại trong vài phút

URL cơ sở

https://api.zelnum.com/api/v1

Tên miền API được tách riêng khỏi tên miền Console một cách có chủ đích, để API có thể mở rộng và được bảo vệ độc lập. Vì vậy ví dụ ở đây dùng api.zelnum.com, còn bảng điều khiển của bạn nằm tại app.zelnum.com.

Xác thực

Tất cả endpoint yêu cầu khóa API trong header của request.

Định dạng phản hồi

Tất cả endpoint trả về JSON.

Quy trình thông thường

Lấy số dư — GET /v1/balance
Gửi kiểm tra (Số) — POST /v1/detect · POST /v1/detect/file
Lấy trạng thái tác vụ — GET /v1/tasks/{token}
Lấy URL tải xuống — GET /v1/tasks/{token}/result · GET /v1/tasks/{token}/download

Kiểm tra một số theo thời gian thực

SDK chính thức

Client Python bọc các endpoint trên trang này: phản hồi có kiểu, idempotency key và tải kết quả hàng loạt. Đây hiện là SDK chính thức duy nhất — các ngôn ngữ khác gọi trực tiếp REST API.

Python — https://github.com/Zelnum/zelnum-python · https://pypi.org/project/zelnum/