Kết nối API cho đại lý
Liên kết tài khoản DMS với iNET, tạo API key đại lý và gọi thử API trên developers.inet.vn
API đại lý trên developers.inet.vn là bản REST thay cho bộ API token cũ ở dms.inet.vn. Thay vì gửi header token, bạn gọi qua cổng developers.inet.vn/api/gateway/v1/reseller/... bằng API key inet_sk_ (ngữ cảnh Đại lý). Mọi thao tác vẫn chạy dưới đúng tài khoản đại lý của bạn trên DMS, với cùng quyền và số dư.
Chỉ tài khoản chủ đại lý mới tạo được API key đại lý. Tài khoản nhân viên của đại lý chưa được hỗ trợ.
Bước 1 — Liên kết tài khoản DMS với tài khoản iNET
API đại lý nhận diện bạn qua liên kết giữa tài khoản DMS (dms.inet.vn) và tài khoản iNET SSO (sso.inet.vn).
- Đăng nhập
dms.inet.vnbằng tài khoản chủ đại lý. - Mở menu tài khoản (góc trên phải) → Liên kết tài khoản iNET (hoặc vào thẳng
/rms/account/link-inet). - Làm theo hướng dẫn: bạn sẽ đăng nhập tài khoản iNET và xác nhận liên kết. Nếu chưa có tài khoản iNET, hãy đăng ký trước tại
sso.inet.vn.
Liên kết xong, cùng một email iNET đó sẽ dùng được ở developers.inet.vn.
Bước 2 — Tạo API key đại lý trên developers.inet.vn
- Vào developers.inet.vn và Đăng nhập bằng chính tài khoản iNET vừa liên kết.
- Mở API Keys trong Dashboard → Tạo API Key.
- Ở ô Ngữ cảnh (Context), chọn Đại lý (RESELLER). (Ô này chỉ hiện với tài khoản đã liên kết đại lý.)
- Đặt tên key, tạo và lưu lại chuỗi
inet_sk_...— key chỉ hiện một lần.
Huỷ liên kết hoặc đổi sang đại lý khác sẽ khoá mọi key đại lý cũ. Khi đó bạn cần tạo key mới.
Bước 3 — Gọi thử API
Dùng key vừa tạo ở header Authorization: Bearer. Ví dụ lấy danh sách quốc gia:
curl "https://developers.inet.vn/api/gateway/v1/reseller/countries" \
-H "Authorization: Bearer inet_sk_..."
Thử một endpoint có tham số — tìm khách hàng của đại lý:
curl "https://developers.inet.vn/api/gateway/v1/reseller/customers?page=1&pageSize=20" \
-H "Authorization: Bearer inet_sk_..."
Toàn bộ danh sách endpoint, tham số và ví dụ nằm ở mục API Đại lý trong Tra cứu API. Mỗi endpoint có nút Try It để gọi thử ngay trong trình duyệt.
Khác biệt so với API token DMS cũ
| API token DMS (cũ) | API đại lý trên developers (mới) | |
|---|---|---|
| Địa chỉ | dms.inet.vn/api/rms/v1/... | developers.inet.vn/api/gateway/v1/reseller/... |
| Xác thực | Header token: <token> | Header Authorization: Bearer inet_sk_... |
| Kiểu đường dẫn | RPC (/domain/detail) | REST (/domains/{id}) |
| Phân trang | page bắt đầu từ 0 | page bắt đầu từ 1 |
| Giới hạn tần suất | — | Có, trả về ở header x-ratelimit-* |
| Nhật ký & thống kê | — | Theo từng API key trong Dashboard |
Định dạng phản hồi chung (bọc success/data/error) xem ở Định dạng phản hồi.
Lỗi thường gặp
- 401 — thiếu hoặc sai API key.
- 403 "chỉ nhận API key ngữ cảnh đại lý" — bạn đang dùng key cá nhân; hãy tạo key ngữ cảnh Đại lý.
- 403 huỷ liên kết đại lý — tài khoản chưa liên kết (hoặc đã gỡ) với đại lý; làm lại Bước 1.
- 429 — vượt giới hạn tần suất; xem
x-ratelimit-resetđể biết thời điểm thử lại.