API Developer

Baca data Anda
dari sistem Anda sendiri.

API baca saja untuk produk dan pesanan Anda sendiri, diamankan dengan kunci API yang Anda buat di aplikasi KopasAI. Tidak ada SDK yang perlu dipasang: klien HTTP apa pun bisa dipakai.

Referensi API

GET /open/me

Menampilkan bisnis pemilik kunci dan scope yang dimilikinya. Berfungsi dengan kunci valid apa pun.

GET /open/products

Produk dan stok: nama, SKU, kategori, satuan, harga, stok dan stok minimum. Memerlukan scope products:read.

GET /open/orders

Pesanan dengan kanal, status, status pembayaran, jumlah dan banyaknya item. Nomor telepon, alamat dan catatan pelanggan tidak pernah disertakan. Memerlukan scope orders:read.

SEGERA tulis / webhook

Belum tersedia: API tidak dapat membuat atau mengubah data, dan tidak mengirim webhook.

list_products.sh

cURL

Ini permintaan yang benar-benar berfungsi. Belum ada SDK resmi; gunakan cURL atau klien HTTP apa pun.

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}}

Buat kunci API di aplikasi

Spesifikasi Teknis

Parameter	Nilai
URL Dasar	`https://api.amcoreai.com/api/v1`
Autentikasi	`Authorization: Bearer kop_sk_...`
Ukuran halaman	`limit` dari 1 sampai 100, bawaan 50
Jumlah	Rupiah bulat (`IDR_MAJOR`): 15000 berarti Rp 15.000
Batas laju	100 permintaan per 15 menit per alamat IP

Penanganan Error

Kode	Arti
`400`	`limit` bukan bilangan bulat dari 1 sampai 100
`401`	Kunci API tidak ada, salah atau sudah dicabut
`403`	Kunci tidak memiliki scope yang diperlukan endpoint ini
`429`	Terlalu banyak permintaan; tunggu lalu coba lagi

Apa yang Anda Terima

Setiap respons berupa JSON dengan dua bagian: data berisi item dan meta memberi tahu cara membacanya.

• meta.amountUnit - selalu IDR_MAJOR, jadi Anda tidak perlu menebak satuannya
• meta.truncated - true jika jumlah item melebihi limit Anda
• meta.customerFieldsOmitted - pada pesanan: data pribadi pelanggan sengaja tidak disertakan

Alat & Bantuan.

Klien HTTP Apa Pun

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

Kunci di Aplikasi

Buat, beri nama, dan cabut kunci di modul Developer API pada aplikasi KopasAI.

SDK Resmi

Segera hadir. Sampai saat itu, gunakan contoh HTTP di halaman ini.

Ada Pertanyaan Tentang API?

Ceritakan apa yang ingin Anda bangun dan kami akan membantu Anda memulai.

Hubungi Kami

Kunci API

Ditampilkan sekali, dapat dicabut kapan saja.

Cara KopasAI menjaga data Anda →

Baca data Anda dari sistem Anda sendiri.