Xác thực API
Cách tạo API Key và xác thực khi gọi API iNET.
Tất cả API của iNET đều yêu cầu xác thực bằng API Key. Mỗi request phải có header Authorization.
Tạo API Key
- Đăng nhập vào Dashboard iNET Developers
- Vào menu API Keys
- Nhấn Tạo API Key
- Đặt Tên Key, rồi giới hạn quyền của key nếu cần:
- Phạm vi truy cập: các dịch vụ key được phép gọi; để trống là cho phép tất cả
- Phương thức HTTP: ví dụ chỉ chọn
GETđể key chỉ đọc dữ liệu; để trống là cho phép tất cả - IP được phép: chỉ nhận request từ các IP hoặc dải CIDR này; để trống là cho phép mọi IP
- Hết hạn: thời điểm key ngừng hoạt động
- Nhấn Tạo Key và copy key ngay lập tức
API Key có dạng: inet_sk_xxxxxxxxxxxxxxxxxxxxxxxx
Quan trọng: Key chỉ hiển thị 1 lần duy nhất. Nếu mất, bạn cần tạo key mới.
Sử dụng API Key
Thêm header Authorization vào mỗi request:
Authorization: Bearer inet_sk_your_key_here
curl -H "Authorization: Bearer inet_sk_your_key_here" \
"https://developers.inet.vn/api/gateway/v1/domain/whois/inet.vn"Bảo mật API Key
- Không commit API Key vào git repository
- Lưu key trong environment variables (.env)
- Sử dụng key khác nhau cho development và production
- Rotate key định kỳ (tạo key mới, xóa key cũ)
- Giới hạn quyền ở mức cần dùng: chỉ chọn dịch vụ, phương thức HTTP và IP cần thiết
Lỗi xác thực thường gặp
Khi xác thực thất bại, API trả {"success": false, "error": "<thông báo>"} kèm mã HTTP:
| HTTP Status | Thông báo trong error | Nguyên nhân |
|---|---|---|
| 401 | API key không hợp lệ hoặc chưa được cung cấp | Thiếu header Authorization, hoặc key sai |
| 401 | API key đã hết hạn, vui lòng tạo key mới | Key đã quá thời hạn |
| 401 | API key đã bị vô hiệu hóa | Key đã bị thu hồi |
| 403 | API key đã bị chặn, vui lòng liên hệ hỗ trợ | Key bị chặn |
| 403 | API key không có quyền truy cập tài nguyên này | API nằm ngoài phạm vi truy cập hoặc phương thức HTTP của key |
Các mã HTTP khác xem ở Định dạng phản hồi và xử lý lỗi.