1. Xác thực
Mọi request đều cần header X-API-Key. Key được cấp trong khu quản trị, mục B2B API.
2. Kiểm tra IMEI
POST /api/v2/check — trả về tình trạng giới hạn mạng trên các nhà mạng Nhật. Tham số bắt buộc: imei (15 số, hợp lệ Luhn). Tuỳ chọn: carriers (mảng), mặc định tra mọi nhà mạng.
3. Tra cứu Samsung
POST /api/v2/samsung — trả về model, serial, CSC, bảo hành và tình trạng KG theo IMEI.
4. Mã lỗi
401 UNAUTHORIZED: thiếu hoặc sai API key. 403 QUOTA_EXCEEDED: hết lượt trong ngày. 403 BLOCKED: key đã bị vô hiệu hoá. 422 INVALID_IMEI: IMEI sai định dạng hoặc sai Luhn.
5. Giới hạn
Mặc định 60 request/phút mỗi API key. Vượt giới hạn trả HTTP 429 kèm header Retry-After. Mọi request đều được ghi log và xem được ở mục Nhật ký.