Developer documentation
Tài liệu KOVITEL IoT API
REST API để quản lý pool data và vòng đời eSIM IoT trên hạ tầng Viettel M2M. Các thao tác thay đổi trạng thái chạy bất đồng bộ qua hàng đợi và trả về jobId.
Base URL
https://api.iot.kovitel.com/api/v1
curl -H "x-api-key: $KOVITEL_API_KEY" \
"https://api.iot.kovitel.com/api/v1/pool/status"Quickstart
Tạo key, allocate eSIM và gọi API đầu tiên trong vài phút.
Xác thực
Header x-api-key, rotate key, rate limit và trạng thái tài khoản.
Vòng đời eSIM
Inventory, allocate, activate, suspend, resume, release và batch.
Webhook
Sự kiện, HMAC signature, retry và delivery log.
Ba bước để bắt đầu
Tạo tài khoản partner
Đăng ký tại /register, nhận API key một lần và lưu vào secret manager.
Kiểm tra pool & inventory
Gọi /pool/status và /sim/inventory để xác nhận tài khoản đã được cấu hình.
Allocate hoặc đổi trạng thái
Gọi /sim/allocate hoặc PUT /sim/{iccid}/status, sau đó poll job hoặc chờ webhook.
Cần hỗ trợ tích hợp?
Gửi mô tả luồng và môi trường của bạn tới KOVITEL.