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
ดูออเดอร์ย้อนหลังของร้านคุณ (รวมรหัสที่ส่งไปแล้ว)
รหัสข้อผิดพลาด
| HTTP | error | ความหมาย |
|---|---|---|
| 400 | invalid_items / idempotency_key_required | รูปแบบคำขอไม่ถูกต้อง |
| 401 / 403 | invalid_api_key / partner_suspended | key ผิด หรือบัญชีถูกระงับ |
| 402 | insufficient_balance | ยอดเงินไม่พอ — ติดต่อร้านเพื่อเติมเงิน |
| 404 | unknown_sku / order_not_found | ไม่มีสินค้า/ออเดอร์นี้ |
| 409 | out_of_stock / order_failed | สต็อกไม่พอ หรือออเดอร์เดิมล้มเหลว (คืนเงินแล้ว) |
| 502 | fulfilment_failed | จัดส่งไม่สำเร็จ ระบบคืนเงินเข้ายอดให้อัตโนมัติ — ลองใหม่ด้วยคีย์ใหม่ |
ข้อควรรู้
- บัญชี ChatGPT แบบแชร์: ส่งให้ลูกค้าได้ทันทีหลังสั่งซื้อ ข้อมูลที่ส่งไปแล้วเรียกคืนไม่ได้ ครบกำหนดแพ็กเกจ AI4YOU จะเปลี่ยนรหัส 2FA ของบัญชีเอง
- ราคาและรายการสินค้าอาจเปลี่ยนได้ — เรียก
/productsก่อนสั่งทุกครั้งหากต้องการราคาล่าสุด - เงื่อนไขและระยะประกันของแต่ละสินค้า: /partner-terms.html (Gemini ของพาร์ตเนอร์ประกัน 24 ชั่วโมง)
- ขอเคลมหรือสอบถาม ติดต่อ AI4YOU พร้อมเลข
order_id