开发者 API
读取您的数据，
读取您的数据，
从您自己的系统中。
针对您自己的商品和订单的只读 API，通过您在 KopasAI 应用中创建的 API 密钥进行保护。无需安装 SDK：任何 HTTP 客户端均可使用。
API 参考
GET
/open/me
显示该密钥所属的商家及其拥有的权限范围（scope）。任何有效密钥均可使用。
GET
/open/products
商品与库存：名称、SKU、类别、单位、价格、库存及最低库存。需要 products:read 权限范围。
GET
/open/orders
订单，含渠道、状态、支付状态、金额和商品数量。从不包含客户电话号码、地址和备注。需要 orders:read 权限范围。
即将推出
写入 / webhook
暂不提供：API 无法创建或修改数据，也不发送 webhook。
list_products.sh
cURL
这是可以直接运行的真实请求。目前没有官方 SDK，用 cURL 或任何 HTTP 客户端即可。
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}}
技术规格
| 参数 | 值 |
|---|---|
| 基础 URL | https://api.amcoreai.com/api/v1 |
| 身份验证 | Authorization: Bearer kop_sk_... |
| 每页数量 | limit 取值 1 至 100，默认 50 |
| 金额 | 整数卢比（IDR_MAJOR）：15000 表示 Rp 15,000 |
| 速率限制 | 每个 IP 地址每 15 分钟 100 次请求 |
错误处理
| 代码 | 含义 |
|---|---|
400 | limit 不是 1 至 100 之间的整数 |
401 | API 密钥缺失、错误或已被撤销 |
403 | 该密钥没有此端点所需的权限范围 |
429 | 请求过多；请稍候再试 |
返回内容
每个响应都是包含两部分的 JSON：data 存放条目，meta 告诉您如何解读它们。
- •
meta.amountUnit- 始终为IDR_MAJOR，您无需猜测单位 - •
meta.truncated- 条目数超过您的limit时为true - •
meta.customerFieldsOmitted- 订单中：客户个人数据被有意省略
工具 & 帮助。
任意 HTTP 客户端
cURL、fetch、Python requests：该 API 就是使用 Bearer 密钥的普通 HTTPS。
在应用中管理密钥
在 KopasAI 应用的 Developer API 模块中创建、命名和吊销密钥。
官方 SDK
即将推出。在此之前，请使用本页的 HTTP 示例。