API ba dezenvolvedór

Lee Ita-nia dadus
husi Ita-nia sistema rasik.

API lee de'it ba Ita-nia produtu no enkomenda rasik, proteje ho xave API ne'ebé Ita kria iha aplikasaun KopasAI. La iha SDK atu instala: klient HTTP saida de'it bele uza.

Referénsia API

GET /open/me

Hatudu negósiu ne'ebé mak na'in ba xave no scope saida mak nia iha. Funsiona ho xave válidu saida de'it.

GET /open/products

Produtu no stok: naran, SKU, kategoria, unidade, presu, stok no stok mínimu. Presiza scope products:read.

GET /open/orders

Enkomenda ho kanál, estadu, estadu pagamentu, montante no númeru item. Númeru telefone, enderesu no nota kliente nian nunka tama. Presiza scope orders:read.

LALAIS hakerek / webhook

Seidauk disponível: API la bele kria ka muda dadus, no la haruka webhook.

list_products.sh

cURL

Ida-ne'e pedidu loos. Seidauk iha SDK ofisiál; uza cURL ka klienti HTTP ruma.

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

Kria xave API iha aplikasaun

Espesifikasaun téknika

Parámetru	Valór
URL baze	`https://api.amcoreai.com/api/v1`
Autentikasaun	`Authorization: Bearer kop_sk_...`
Tamañu pájina	`limit` husi 1 to'o 100, padraun 50
Montante	Rupia tomak (`IDR_MAJOR`): 15000 signifika Rp 15.000
Limite frekuénsia	Pedidu 100 kada minutu 15 kada enderesu IP

Jestaun erru

Kódigu	Signifikadu
`400`	`limit` la'ós númeru tomak husi 1 to'o 100
`401`	Xave API la iha, sala ka kansela ona
`403`	Xave la iha scope ne'ebé endpoint ida-ne'e presiza
`429`	Pedidu barak liu; hein no koko fali

Saida mak Ita simu fali

Resposta hotu mak JSON ho parte rua: data kaer item sira no meta hatete oinsá atu lee sira.

• meta.amountUnit - sempre IDR_MAJOR, nune'e Ita la presiza hatene-hatene unidade
• meta.truncated - true bainhira item barak liu Ita-nia limit
• meta.customerFieldsOmitted - iha enkomenda: dadus pesoál kliente nian la tama ho intensaun

Ferramenta & Ajuda.

Kliente HTTP saida de'it

cURL, fetch, Python requests: API ne'e HTTPS simples ho xave Bearer.

Xave iha Aplikasaun

Kria, fó naran no revoga xave sira iha módulu Developer API husi aplikasaun KopasAI.

SDK Ofisiál sira

Lakleur tan. To'o ne'ebá, uza ezemplu HTTP sira iha pájina ne'e.

Iha Pergunta Kona-ba API?

Hato'o mai ami saida mak Ita hakarak harii no ami sei ajuda Ita hahú.

Kontaktu Ami

Xave API

Hatudu dala ida de'it, bele kansela iha tempu naran de'it.

Oinsá KopasAI rai Ita-nia dadus →

Lee Ita-nia dadus husi Ita-nia sistema rasik.