Tham chiếu cấu hình API
Tóm tắt
Trang này liệt kê các thông số cấu hình cố định của Elimapi — base URL, header, nền tảng, giới hạn request và công cụ kiểm thử. Mọi request API đều dùng chung các thông số này.
Base URL
| Môi trường | URL | Ghi chú |
|---|---|---|
| Production | https://openapi.elim.asia | Môi trường duy nhất hiện tại |
Phương thức và header
- Phương thức request: POST cho hầu hết API endpoints (một số endpoint truy vấn dùng GET).
- Bắt buộc header
Content-Type: application/json. - Bắt buộc gọi qua HTTPS trong mọi request.
- Yêu cầu xác thực qua Bearer Token hoặc API Key — xem Tham chiếu xác thực.
Nền tảng hỗ trợ
| Nền tảng | Trạng thái | Ghi chú |
|---|---|---|
| Taobao | ✅ Hoạt động | Hỗ trợ đầy đủ các API |
| 1688 | ✅ Hoạt động | Hỗ trợ đầy đủ các API |
Giới hạn request
| Giới hạn | Giá trị |
|---|---|
| Kích thước request body | Tối đa 50MB |
| Rate limit mặc định | 100 requests / 60 giây |
| Rate limit gói Free | 30 requests / 60 giây |
| Upload ảnh | Multipart (file) — không giới hạn kích thước phía API |
Ghi chú rate limit:
- Giới hạn chung mặc định là 100 requests/phút; tài khoản ở gói Free bị giới hạn 30 requests/phút.
- Admin có thể cấu hình giới hạn riêng cho từng user; một số endpoint có giới hạn riêng (ví dụ: product API 300 req/60s, order preview 20 req/60s, unshorten 20 req/60s).
- Mỗi response đính kèm header
X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Resetđể theo dõi hạn mức thực tế của tài khoản.
Rate limit cụ thể từng endpoint được ghi trong tài liệu của endpoint đó.
Công cụ kiểm thử API
| Công cụ | Link tải | Ghi chú |
|---|---|---|
| Postman | postman.com/downloads | Hỗ trợ collections, environment variables |
| Insomnia | insomnia.rest/download | Lưu request thành collection, dùng environment variables cho base URL và token |
Cấu hình mẫu cho mọi công cụ:
POST https://openapi.elim.asia/v1/products/search
Content-Type: application/json
Authorization: Bearer {your_access_token} # hoặc x-api-key: {your_api_key}
Hỗ trợ kỹ thuật
- Email: [email protected]
- Hotline: 0934 577 886
Liên kết liên quan
- Làm theo: Xác thực API requests — lấy token/key và kiểm thử request đầu tiên
- Tham chiếu: Xác thực · API sản phẩm · API đơn hàng