API para sa Developer

Basahin ang iyong data
mula sa sarili mong mga system.

Isang read-only na API para sa sarili mong mga produkto at order, na pinoprotektahan ng mga API key na ginagawa mo sa KopasAI app. Walang SDK na kailangang i-install: gagana ang kahit anong HTTP client.

Sanggunian ng API

GET /open/me

Ipinapakita kung saang negosyo kabilang ang key at kung anong mga scope ang mayroon ito. Gumagana sa kahit anong valid na key.

GET /open/products

Mga produkto at stock: pangalan, SKU, kategorya, unit, presyo, stock at minimum na stock. Kailangan ang scope na products:read.

GET /open/orders

Mga order kasama ang channel, status, status ng bayad, mga halaga at bilang ng item. Hindi kailanman isinasama ang mga numero ng telepono, address at tala ng customer. Kailangan ang scope na orders:read.

MALAPIT NA pagsulat / mga webhook

Hindi pa available: hindi kayang gumawa o magbago ng data ng API, at hindi ito nagpapadala ng mga webhook.

list_products.sh

cURL

Totoong request ito. Wala pang opisyal na SDK; gumamit ng cURL o anumang HTTP client.

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

Gumawa ng API key sa app

Mga Teknikal na Detalye

Parametro	Halaga
Batayang URL	`https://api.amcoreai.com/api/v1`
Pagpapatunay	`Authorization: Bearer kop_sk_...`
Laki ng pahina	`limit` mula 1 hanggang 100, default 50
Mga halaga	Buong rupiah (`IDR_MAJOR`): ang 15000 ay nangangahulugang Rp 15,000
Limitasyon sa rate	100 request bawat 15 minuto bawat IP address

Pag-handle ng Error

Kodigo	Kahulugan
`400`	Ang `limit` ay hindi buong numero mula 1 hanggang 100
`401`	Wala, mali o binawi na ang API key
`403`	Walang scope ang key na kailangan ng endpoint na ito
`429`	Masyadong maraming request; maghintay at subukang muli

Ano ang Matatanggap Mo

Bawat response ay JSON na may dalawang bahagi: ang data ang naglalaman ng mga item at ang meta ang nagsasabi kung paano ito basahin.

• meta.amountUnit - palaging IDR_MAJOR, kaya hindi mo na kailangang hulaan ang unit
• meta.truncated - true kapag mas marami ang item kaysa sa iyong limit
• meta.customerFieldsOmitted - sa mga order: sadyang hindi isinama ang personal na data ng customer

Mga Tool & Tulong.

Kahit Anong HTTP Client

cURL, fetch, Python requests: ang API ay simpleng HTTPS na may Bearer key.

Mga Key sa App

Gumawa, magpangalan at magbawi ng mga key sa Developer API module ng KopasAI app.

Mga Opisyal na SDK

Malapit na. Hanggang doon, gamitin ang mga halimbawang HTTP sa pahinang ito.

May Tanong Tungkol sa API?

Sabihin sa amin kung ano ang gusto mong buuin at tutulungan ka naming magsimula.

Makipag-ugnayan sa Amin

Mga API Key

Ipinapakita nang isang beses, maaaring bawiin anumang oras.

Paano iniingatan ng KopasAI ang iyong data →

Basahin ang iyong data mula sa sarili mong mga system.