Đọc dữ liệu của bạn
từ chính hệ thống của bạn.
API chỉ đọc cho sản phẩm và đơn hàng của chính bạn, được bảo vệ bằng khóa API bạn tạo trong ứng dụng KopasAI. Không cần cài SDK: bất kỳ HTTP client nào cũng dùng được.
Tài liệu tham khảo API
/open/me
Cho biết khóa thuộc về doanh nghiệp nào và có những phạm vi (scope) nào. Hoạt động với bất kỳ khóa hợp lệ nào.
/open/products
Sản phẩm và tồn kho: tên, SKU, danh mục, đơn vị, giá, tồn kho và tồn kho tối thiểu. Cần phạm vi products:read.
/open/orders
Đơn hàng kèm kênh, trạng thái, trạng thái thanh toán, số tiền và số lượng mặt hàng. Số điện thoại, địa chỉ và ghi chú của khách hàng không bao giờ được đưa vào. Cần phạm vi orders:read.
ghi / webhook
Chưa có: API không thể tạo hoặc thay đổi dữ liệu và không gửi webhook.
curl https://api.amcoreai.com/api/v1/open/products?limit=20 \
-H "Authorization: Bearer kop_sk_..."
# {"data":[{"id":"...","name":"...","price":15000,"stock":12,...}],
# "meta":{"amountUnit":"IDR_MAJOR","truncated":false,"returned":20}}
Thông số kỹ thuật
| Tham số | Giá trị |
|---|---|
| URL gốc | https://api.amcoreai.com/api/v1 |
| Xác thực | Authorization: Bearer kop_sk_... |
| Kích thước trang | limit từ 1 đến 100, mặc định 50 |
| Số tiền | Rupiah nguyên (IDR_MAJOR): 15000 nghĩa là Rp 15.000 |
| Giới hạn tần suất | 100 yêu cầu mỗi 15 phút cho mỗi địa chỉ IP |
Xử lý lỗi
| Mã | Ý nghĩa |
|---|---|
400 | limit không phải là số nguyên từ 1 đến 100 |
401 | Khóa API bị thiếu, sai hoặc đã bị thu hồi |
403 | Khóa không có phạm vi quyền mà điểm cuối này yêu cầu |
429 | Quá nhiều yêu cầu; hãy chờ rồi thử lại |
Dữ liệu bạn nhận về
Mọi phản hồi đều là JSON gồm hai phần: data chứa các mục và meta cho bạn biết cách đọc chúng.
- •
meta.amountUnit- luôn làIDR_MAJOR, nên bạn không bao giờ phải đoán đơn vị - •
meta.truncated-truekhi số mục nhiều hơnlimitcủa bạn - •
meta.customerFieldsOmitted- với đơn hàng: dữ liệu cá nhân của khách hàng được cố ý loại bỏ
Công cụ & Trợ giúp.
Bất kỳ ứng dụng khách HTTP nào
cURL, fetch, Python requests: API là HTTPS thông thường với khóa Bearer.
Khóa trong ứng dụng
Tạo, đặt tên và thu hồi khóa trong mô-đun Developer API của ứng dụng KopasAI.
SDK chính thức
Sắp ra mắt. Trong lúc chờ, hãy dùng các ví dụ HTTP trên trang này.
Có câu hỏi về API?
Hãy cho chúng tôi biết bạn muốn xây dựng gì và chúng tôi sẽ giúp bạn bắt đầu.
Liên hệ với chúng tôi