AI4YOU

Partner API

หมายเหตุ: API ใช้ได้เฉพาะบัญชีประเภท Partner API พาร์ตเนอร์ธรรมดา (ใช้ผ่านหน้าเว็บ) ไม่มี API key ถ้าต้องการเปลี่ยนประเภท ติดต่อแอดมินทางไลน์

สำหรับร้านพาร์ตเนอร์ที่เติมเงินล่วงหน้าไว้กับ AI4YOU แล้วสั่งซื้อสินค้าผ่านระบบอัตโนมัติ — Base URL: https://ai4you.click/api/partner/v1

การยืนยันตัวตน

ส่ง API key ทุกครั้งในหัวข้อ Authorization: Bearer ai4y_xxxxxxxx (สมัครได้ที่ /partner-apply.html เมื่ออนุมัติแล้วเข้าสู่ระบบที่ /partner-shop.html ด้วยอีเมลและรหัสผ่าน ระบบออก API key แรกให้ตอนอนุมัติ ดูได้ครั้งเดียวที่แท็บ "บัญชี" และสร้างใหม่ได้ทุกเมื่อ) — ห้ามใส่ key ในหน้าเว็บ/แอปฝั่งลูกค้า ให้เรียกจากเซิร์ฟเวอร์ของร้านเท่านั้น

เติมเครดิตด้วยสลิป

ร้านเติมเองได้ที่หน้าเว็บ /topup.html (เข้าสู่ระบบด้วยอีเมล) หรือเรียก API: GET /topup-info (บัญชีรับโอนและขั้นต่ำ 300 บาท), POST /topups (multipart ฟิลด์ slip = รูป jpg/png/webp ไม่เกิน 5MB), GET /topups, GET /topups/{id}

โอนเข้าบัญชีร้านก่อน แล้วส่งสลิป ระบบตรวจอัตโนมัติและเติมเครดิตเท่ายอดที่โอนจริงทันที (201 status: credited) ถ้าธนาคารยังไม่พบรายการจะตรวจซ้ำให้เอง (202 status: retry) ถ้าตรวจไม่ผ่านหรือยอดต่ำกว่า 300 บาทจะรอแอดมินตรวจ (pending_review) สลิปใบเดียวใช้ได้ครั้งเดียว

GET /products

รายการสินค้า ราคาขายส่ง และสต็อกปัจจุบัน สินค้าที่มีราคาขั้นบันไดจะมี price_tiers (เช่น ซื้อ 3 ชิ้นขึ้นไป ราคาต่อชิ้นลดลง) คิดตามจำนวนใน sku เดียวกันของออเดอร์นั้น

📢 หมายเหตุ: ราคาส่งอาจปรับเปลี่ยนตามค่าเงิน ณ ขณะนั้น กรุณาตรวจสอบราคาแบบเรียลไทม์ (real time) ทุกครั้งก่อนสั่งซื้อ (ดูได้จากฟิลด์ price_note และราคาใน price ของคำตอบนี้)

curl -H "Authorization: Bearer $KEY" https://ai4you.click/api/partner/v1/products

{ "products": [
  { "sku": "chatgpt-personal-459-v1", "name": "ChatGPT ส่วนตัว 30 วัน • บัญชีส่วนตัว",
    "price": 400, "currency": "THB", "duration_days": 30, "stock": 2, "in_stock": true } ] }

GET /balance

{ "balance": 600, "currency": "THB" }

POST /orders

สั่งซื้อ ระบบหักยอดเงินแล้วส่งรหัสกลับทันทีในคำตอบเดียว ต้องส่งหัวข้อ Idempotency-Key (สตริงไม่ซ้ำต่อออเดอร์ 8–100 ตัวอักษร) — ถ้าเน็ตหลุดแล้วส่งซ้ำด้วยคีย์เดิม จะได้ออเดอร์เดิมกลับมาและไม่ถูกหักเงินซ้ำ

curl -X POST https://ai4you.click/api/partner/v1/orders \
  -H "Authorization: Bearer $KEY" -H "Idempotency-Key: shop77-order-1001" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"sku":"chatgpt-personal-459-v1","quantity":1}],"reference":"ออเดอร์ร้านคุณ #1001"}'

201 { "order_id": "API-1A2B3C4D", "status": "completed", "total": 400, "balance": 600,
  "items": [ { "sku": "...", "quantity": 1, "unit_price": 400,
    "accounts": [ { "credentials": "email|password|2fa-secret", "delivery_form": "วิธีเข้าใช้งาน ..." } ] } ] }

credentials คือข้อมูลดิบของบัญชี ส่วน delivery_form คือข้อความสำเร็จรูปสำหรับส่งลูกค้า (มีให้เฉพาะ ChatGPT และ Gemini) — จำกัด 10 ชิ้นต่อ sku ต่อออเดอร์

GET /orders/{order_id} และ GET /orders?limit=20

ดูออเดอร์ย้อนหลังของร้านคุณ (รวมรหัสที่ส่งไปแล้ว)

รหัสข้อผิดพลาด

HTTPerrorความหมาย
400invalid_items / idempotency_key_requiredรูปแบบคำขอไม่ถูกต้อง
401 / 403invalid_api_key / partner_suspendedkey ผิด หรือบัญชีถูกระงับ
402insufficient_balanceยอดเงินไม่พอ — ติดต่อร้านเพื่อเติมเงิน
404unknown_sku / order_not_foundไม่มีสินค้า/ออเดอร์นี้
409out_of_stock / order_failedสต็อกไม่พอ หรือออเดอร์เดิมล้มเหลว (คืนเงินแล้ว)
502fulfilment_failedจัดส่งไม่สำเร็จ ระบบคืนเงินเข้ายอดให้อัตโนมัติ — ลองใหม่ด้วยคีย์ใหม่

ข้อควรรู้