API Pembangun

Baca data anda
dari sistem anda sendiri.

API baca sahaja untuk produk dan pesanan anda sendiri, dilindungi dengan kunci API yang anda cipta dalam aplikasi KopasAI. Tiada SDK untuk dipasang: mana-mana klien HTTP boleh digunakan.

Rujukan API

GET /open/me

Menunjukkan perniagaan mana yang memiliki kunci itu dan skop yang dimilikinya. Berfungsi dengan mana-mana kunci yang sah.

GET /open/products

Produk dan stok: nama, SKU, kategori, unit, harga, stok dan stok minimum. Memerlukan skop products:read.

GET /open/orders

Pesanan dengan saluran, status, status pembayaran, amaun dan bilangan item. Nombor telefon, alamat dan nota pelanggan tidak pernah disertakan. Memerlukan skop orders:read.

AKAN DATANG tulis / webhook

Belum tersedia: API tidak boleh mencipta atau mengubah data, dan tidak menghantar webhook.

list_products.sh

cURL

Ini permintaan sebenar. Belum ada SDK rasmi; gunakan cURL atau mana-mana klien 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}}

Cipta kunci API dalam aplikasi

Spesifikasi Teknikal

Parameter	Nilai
URL Asas	`https://api.amcoreai.com/api/v1`
Pengesahan	`Authorization: Bearer kop_sk_...`
Saiz halaman	`limit` dari 1 hingga 100, lalai 50
Amaun	Rupiah penuh (`IDR_MAJOR`): 15000 bermaksud Rp 15,000
Had kadar	100 permintaan setiap 15 minit bagi setiap alamat IP

Pengendalian Ralat

Kod	Maksud
`400`	`limit` bukan nombor bulat dari 1 hingga 100
`401`	Kunci API tiada, salah atau telah dibatalkan
`403`	Kunci tidak mempunyai skop yang diperlukan oleh endpoint ini
`429`	Terlalu banyak permintaan; tunggu dan cuba lagi

Apa yang Anda Terima

Setiap respons ialah JSON dengan dua bahagian: data memuatkan item dan meta memberitahu cara membacanya.

• meta.amountUnit - sentiasa IDR_MAJOR, jadi anda tidak perlu meneka unitnya
• meta.truncated - true apabila item lebih banyak daripada limit anda
• meta.customerFieldsOmitted - pada pesanan: data peribadi pelanggan sengaja tidak disertakan

Alat & Bantuan.

Mana-mana Klien HTTP

cURL, fetch, Python requests: API ini ialah HTTPS biasa dengan kunci Bearer.

Kunci dalam Aplikasi

Cipta, namakan dan batalkan kunci dalam modul Developer API aplikasi KopasAI.

SDK Rasmi

Akan datang. Sementara itu, gunakan contoh HTTP di halaman ini.

Ada Soalan Tentang API?

Beritahu kami apa yang ingin anda bina dan kami akan membantu anda bermula.

Hubungi Kami

Kunci API

Dipaparkan sekali, boleh dibatalkan pada bila-bila masa.

Cara KopasAI menjaga data anda →

Baca data anda dari sistem anda sendiri.