Read your data
from your own systems.
A read-only API for your own products and orders, secured with API keys you create in the KopasAI app. There is no SDK to install: any HTTP client works.
API Reference
/open/me
Shows which business the key belongs to and which scopes it has. Works with any valid key.
/open/products
Products and stock: name, SKU, category, unit, price, stock and minimum stock. Needs the products:read scope.
/open/orders
Orders with channel, status, payment status, amounts and item count. Customer phone numbers, addresses and notes are never included. Needs the orders:read scope.
write / webhooks
Not available yet: the API cannot create or change data, and it does not send webhooks.
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}}
Technical Specifications
| Parameter | Value |
|---|---|
| Base URL | https://api.amcoreai.com/api/v1 |
| Authentication | Authorization: Bearer kop_sk_... |
| Page size | limit from 1 to 100, default 50 |
| Amounts | Whole rupiah (IDR_MAJOR): 15000 means Rp 15,000 |
| Rate limit | 100 requests per 15 minutes per IP address |
Error Handling
| Code | Meaning |
|---|---|
400 | limit is not a whole number from 1 to 100 |
401 | The API key is missing, wrong or revoked |
403 | The key does not have the scope this endpoint needs |
429 | Too many requests; wait and try again |
What You Get Back
Every response is JSON with two parts: data holds the items and meta tells you how to read them.
- •
meta.amountUnit- alwaysIDR_MAJOR, so you never have to guess the unit - •
meta.truncated-truewhen there are more items than yourlimit - •
meta.customerFieldsOmitted- on orders: customer personal data is left out on purpose
Tools & Help.
Any HTTP Client
cURL, fetch, Python requests: the API is plain HTTPS with a Bearer key.
Keys in the App
Create, name and revoke keys in the Developer API module of the KopasAI app.
Official SDKs
Coming soon. Until then, use the HTTP examples on this page.
Questions About the API?
Tell us what you want to build and we will help you get started.
Contact Us