Mula pantas

Baca produk, pesanan, pelanggan, dan prospek kedai anda dari sistem lain — dalam tiga langkah.

API v1 baca sahaja. Setiap endpoint ialah GET. Menulis melalui API bermakna satu kunci yang bocor boleh menukar harga atau menanda pesanan sebagai lunas, jadi laluan baca perlu terbukti selamat dahulu. Bila laluan tulis dibuka, ia akan datang sebagai skop baharu — endpoint sedia ada tidak akan berubah.

1. Buat kunci

Buka Apps → API & Kunci dalam panel admin, beri nama, dan pilih kebenaran yang paling sedikit yang mencukupi. Kunci dipaparkan sekali sahaja — ia tidak disimpan dalam bentuk yang boleh dibaca semula, jadi tiada laluan untuk memaparkannya lagi.

2. Panggil endpoint pertama

Kunci dihantar dalam pengepala Authorization. Jangan letakkannya dalam querystring: ia akan berakhir dalam log pelayan, log proksi, dan pengepala Referer.

curl

curl -s "https://www.cuantuan.net/api/v1/auth" \
  -H "Authorization: Bearer ct_live_KUNCI_ANDA"

Jawapan

{
  "ok": true,
  "key": { "id": "ak_9f2c…", "scopes": ["product.read", "order.read"] },
  "store": { "id": "singleton", "name": "Cuantuan", "currency": "MYR" }
}

3. Baca data anda

JavaScript

const res = await fetch("https://www.cuantuan.net/api/v1/order/list?status=PAID&limit=50", {
  headers: { Authorization: `Bearer ${process.env.CUANTUAN_API_KEY}` },
});
const body = await res.json();
if (!body.ok) throw new Error(`${body.code}: ${body.message}`);
for (const pesanan of body.data) {
  console.log(pesanan.code, pesanan.buyer.email, pesanan.total_cents);
}

PHP

$ch = curl_init("https://www.cuantuan.net/api/v1/product/list?active=true");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer " . getenv("CUANTUAN_API_KEY")]);
$body = json_decode(curl_exec($ch), true);
if (!$body["ok"]) { throw new Exception($body["code"] . ": " . $body["message"]); }

Yang perlu diketahui awal

URL asas: https://www.cuantuan.net/api/v1 — versi ada dalam laluan, jadi perubahan yang memutuskan datang sebagai /v2 dan bukan sebagai kejutan pada /v1.
9 endpoint tersedia. Lihat rujukan penuh.
Had 1000 permintaan sejam setiap kunci. Lihat had kadar.
Wang dalam sen. total_cents: 4900 bermakna RM49.00. Tiada nombor perpuluhan dalam jawapan — perpuluhan terapung dan wang tidak sepatutnya bertemu.
Masa dalam UTC, format ISO 8601.

Seterusnya: Pengesahan & kebenaran →