เริ่มต้นใช้งาน
API สำหรับนักพัฒนา

อ่านข้อมูลของคุณ
จากระบบของคุณเอง

API แบบอ่านอย่างเดียวสำหรับสินค้าและคำสั่งซื้อของคุณเอง ปกป้องด้วยคีย์ API ที่คุณสร้างในแอป KopasAI ไม่ต้องติดตั้ง SDK: ใช้ไคลเอนต์ HTTP ใดก็ได้

เอกสารอ้างอิง API

GET /open/me

แสดงว่าคีย์เป็นของธุรกิจใดและมีขอบเขต (scope) ใดบ้าง ใช้ได้กับคีย์ที่ถูกต้องทุกคีย์

GET /open/products

สินค้าและสต็อก: ชื่อ, SKU, หมวดหมู่, หน่วย, ราคา, สต็อก และสต็อกขั้นต่ำ ต้องมีขอบเขต products:read

GET /open/orders

คำสั่งซื้อพร้อมช่องทาง สถานะ สถานะการชำระเงิน จำนวนเงิน และจำนวนรายการ ไม่มีการใส่เบอร์โทรศัพท์ ที่อยู่ และหมายเหตุของลูกค้าเลย ต้องมีขอบเขต orders:read

เร็วๆ นี้ เขียน / webhook

ยังไม่พร้อมใช้งาน: API ไม่สามารถสร้างหรือแก้ไขข้อมูล และไม่ส่ง webhook

list_products.sh
cURL
นี่คือคำขอจริง ยังไม่มี SDK อย่างเป็นทางการ ใช้ cURL หรือไคลเอนต์ 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}}

ข้อมูลจำเพาะทางเทคนิค

พารามิเตอร์ค่า
URL หลักhttps://api.amcoreai.com/api/v1
การยืนยันตัวตนAuthorization: Bearer kop_sk_...
ขนาดหน้าlimit ตั้งแต่ 1 ถึง 100 ค่าเริ่มต้น 50
จำนวนเงินรูเปียห์เต็มจำนวน (IDR_MAJOR): 15000 หมายถึง Rp 15,000
ขีดจำกัดอัตราคำขอ100 คำขอต่อ 15 นาทีต่อที่อยู่ IP

การจัดการข้อผิดพลาด

รหัสความหมาย
400limit ไม่ใช่จำนวนเต็มตั้งแต่ 1 ถึง 100
401ไม่มีคีย์ API, คีย์ไม่ถูกต้อง หรือถูกเพิกถอนแล้ว
403คีย์ไม่มีขอบเขตที่เอนด์พอยต์นี้ต้องการ
429คำขอมากเกินไป โปรดรอแล้วลองอีกครั้ง

สิ่งที่คุณได้รับกลับมา

ทุกการตอบกลับเป็น JSON ที่มีสองส่วน: data เก็บรายการ และ meta บอกวิธีอ่านรายการเหล่านั้น

  • • meta.amountUnit - เป็น IDR_MAJOR เสมอ คุณจึงไม่ต้องเดาหน่วย
  • • meta.truncated - เป็น true เมื่อมีรายการมากกว่า limit ของคุณ
  • • meta.customerFieldsOmitted - สำหรับคำสั่งซื้อ: ข้อมูลส่วนบุคคลของลูกค้าถูกตัดออกโดยเจตนา

เครื่องมือ & ความช่วยเหลือ

ไคลเอนต์ HTTP ใดก็ได้

cURL, fetch, Python requests: API เป็น HTTPS ธรรมดาที่ใช้คีย์ Bearer

คีย์ในแอป

สร้าง ตั้งชื่อ และเพิกถอนคีย์ได้ในโมดูล API สำหรับนักพัฒนา ของแอป KopasAI

SDK อย่างเป็นทางการ

เร็ว ๆ นี้ ระหว่างนี้ใช้ตัวอย่าง HTTP ในหน้านี้ไปก่อน

มีคำถามเกี่ยวกับ API ไหม?

บอกเราว่าคุณอยากสร้างอะไร แล้วเราจะช่วยให้คุณเริ่มต้นได้

ติดต่อเรา

คีย์ API

แสดงเพียงครั้งเดียว เพิกถอนได้ทุกเมื่อ

KopasAI ดูแลข้อมูลของคุณอย่างไร →