neo.api

ใช้ AI ช่วยเชื่อม Neo API กับ Claude Code, Cursor, ChatGPT

อ่านแบบ Markdown

ให้ AI อ่านเอกสาร Neo API ในรูป Markdown ก่อนเขียนโค้ด อย่าปล่อยให้เดาจากความรู้ทั่วไป ไฟล์ที่ใช้คือ https://neoapihub.com/llms-full.txt (เอกสารทั้งหมด), https://neoapihub.com/docs/seamless.md และ https://neoapihub.com/docs/transfer.md จากนั้นสั่งงานด้วย prompt ที่บอก stack ของคุณ แล้วตรวจโค้ดที่ได้ 4 จุด: การตรวจ header Authorization, การกันรายการซ้ำด้วย providerTransactionId, กติกายอดเงินติดลบ และรหัส status_code ห้ามวาง Private Key ลงในแชทหรือ prompt ให้เก็บใน environment variable

  • Check Balanceผ่าน
  • Transfer In (Bet)ผ่าน
  • Status Code 2: Insufficient Balanceผ่าน
  • Status Code 7: Duplicate providerTransactionIdผ่าน
ตรวจโค้ดที่ AI เขียนด้วยหน้า Callback Test ในหลังบ้านก่อนเปิดจริง

ทำไมต้องส่งเอกสารให้ AI

AI รู้รูปแบบ casino wallet API ทั่วไป แต่ไม่รู้รายละเอียดของ Neo API ถ้าไม่มีเอกสาร มักเดาผิดแบบนี้

  • ตั้งชื่อฟิลด์เอง เช่น amount, txId, balance_after แทน transferIn, transferOut, providerTransactionId, balanceAfter
  • ใส่การตรวจ HMAC signature ของ body ซึ่งไม่มีในเอกสาร Neo API ใช้วิธีแนบ Private Key ใน header Authorization และให้ฝั่งคุณเทียบค่านี้
  • ตอบผลด้วย status หรือ code แทน status_code ซึ่ง Neo API ใช้ตัดสินว่ารายการสำเร็จหรือไม่
  • ไม่รู้ว่า rtp ใน init-session ต้องอยู่ในช่วง 30–99 หรือว่า clientIp จำเป็นสำหรับเกมค่าย PG

ไฟล์เอกสารที่ใช้

URL เนื้อหา ใช้เมื่อ
https://neoapihub.com/llms-full.txt เอกสารทั้งหมดในไฟล์เดียว ยังไม่ได้เลือกแบบเชื่อมต่อ หรืออยากให้ AI เห็นทุกเส้น
https://neoapihub.com/docs/seamless.md แบบ Seamless: callback, get-games, init-session, RTP, ประวัติ เลือก Seamless แล้ว
https://neoapihub.com/docs/transfer.md แบบ Transfer: create-user, transfer-in/out, get-balance, ประวัติ เลือก Transfer แล้ว

ส่งเฉพาะไฟล์ที่ตรงกับงาน AI จะมีที่ว่างใน context สำหรับโค้ดของคุณมากขึ้น ถ้ายังไม่แน่ใจว่าจะใช้แบบไหน อ่าน Seamless กับ Transfer ต่างกันยังไง

วิธีส่งเอกสารให้ AI แต่ละตัว

วิธีที่ได้ผลกับทุกเครื่องมือคือดาวน์โหลดไฟล์มาไว้ใน repo แล้วอ้างถึงไฟล์นั้น

bash
mkdir -p docs/vendor
curl -s https://neoapihub.com/docs/seamless.md -o docs/vendor/neo-seamless.md
  • Claude Code: บอกให้อ่าน docs/vendor/neo-seamless.md ใน prompt หรือให้ดึง URL เองก็ได้ ถ้าเปิดให้ใช้ web fetch
  • Cursor: อ้างไฟล์ด้วย @docs/vendor/neo-seamless.md ในแชท หรือเพิ่ม URL เป็น Docs แล้วเรียกด้วย @
  • ChatGPT: แนบไฟล์ .md เข้าไปในแชท แล้วให้ AI ตอบเป็นโค้ดสำหรับไฟล์ในโปรเจกต์ของคุณ

เอกสารมีการอัปเดต เช่น เดือนกรกฎาคม 2026 ค่าย _plus บางค่ายเปลี่ยน providerId และ gameId ใหม่ทั้งหมด ดาวน์โหลดไฟล์ใหม่ก่อนเริ่มงานรอบใหม่ทุกครั้ง

Prompt พร้อมใช้

แก้ส่วนที่อยู่ใน <...> ให้ตรงกับระบบของคุณ แล้ววางทั้งก้อน

text
อ่านเอกสาร Neo API ในไฟล์ docs/vendor/neo-seamless.md ให้จบก่อนเขียนโค้ด
ใช้ชื่อ endpoint ชื่อฟิลด์ และ status_code ตามเอกสารเท่านั้น ห้ามเพิ่มฟิลด์ที่ไม่มีในเอกสาร

Stack: <เช่น Node.js 20 + Express + PostgreSQL / Laravel 11 + MySQL / Go + chi + Postgres>
ตารางกระเป๋าเงินที่มีอยู่: <ชื่อตาราง และคอลัมน์ username, balance>

งานที่ต้องการ:
1. Endpoint POST <callback base path>/check-balance และ POST <callback base path>/update-balance
   ตาม request/response ในเอกสาร
2. ทุก callback ตรวจ header Authorization เทียบกับ env NEO_PRIVATE_KEY แบบ constant-time
   ก่อนแตะฐานข้อมูล ถ้าไม่ตรงให้ตอบตามตัวอย่างในเอกสาร
3. /update-balance:
   - ทำใน database transaction เดียว ล็อกแถวกระเป๋าของผู้เล่นระหว่างคำนวณ
   - balanceAfter = balanceBefore - transferIn + transferOut
   - providerTransactionId ที่เคยประมวลผลแล้ว: ไม่คิดเงินซ้ำ ตอบ status_code 7 พร้อมยอดปัจจุบัน
   - สร้างตารางบันทึกรายการ มี unique constraint ที่ providerTransactionId
   - transferIn มากกว่ายอดที่มี และ ableNegativeBalance ไม่ใช่ true: ตอบ status_code 2 ไม่ขยับยอด
   - ableNegativeBalance เป็น true: ยอมให้ติดลบ
   - toCancelProviderTransactionId มีค่า: ยกเลิกรายการนั้น ถ้าหาไม่เจอตอบ status_code 8
   - ตอบ status_code 0 หลัง commit สำเร็จเท่านั้น
   - เก็บเงินเป็น decimal ไม่ใช้ float
4. ฟังก์ชันฝั่ง backend เรียก POST https://api.neoapihub.com/api/external/get-games
   และ POST https://api.neoapihub.com/api/external/init-session
   อ่าน NEO_PRIVATE_KEY และ NEO_API_AGENT_ID จาก env ส่ง clientIp เป็น IP จริงของผู้เล่น
   ส่ง isDesktop ตามอุปกรณ์ และคืนผลตาม type (url, html, redirect) ให้ frontend
   ถ้า type เป็น redirect ให้ frontend เปิดใน tab ใหม่ ห้ามใช้ iframe
5. Test อัตโนมัติ: ยอดปกติ, username ไม่มีอยู่, ยอดไม่พอ, providerTransactionId ซ้ำ,
   ableNegativeBalance = true, ยกเลิกรายการที่ไม่มีอยู่, Authorization ผิด

ห้ามใส่ค่า Private Key จริงในโค้ด test หรือ log ใช้ env เท่านั้น
ถ้าเอกสารไม่ได้บอกเรื่องไหน ให้หยุดถามก่อน อย่าเดา

ถ้าใช้แบบ Transfer ให้เปลี่ยนไฟล์เป็น neo-transfer.md และเปลี่ยนข้อ 1–3 เป็นฟังก์ชันเรียก create-user, transfer-in, transfer-out, get-balance และ get-transfer-history พร้อม ledger ฝั่งเว็บที่บันทึก id จาก response ทุกครั้ง

ตรวจโค้ดที่ AI เขียน

อ่านโค้ดทีละข้อ อย่าดูแค่ว่ารันผ่าน

  1. Authorization มาก่อนทุกอย่าง ต้องเทียบ header Authorization กับค่าใน env ก่อน query ฐานข้อมูล ถ้า AI เทียบหลังอ่านยอด หรือข้ามการตรวจใน /check-balance ให้แก้ ถ้าเจอโค้ดตรวจ HMAC หรือ signature ให้ลบออก เพราะเอกสาร Neo API ไม่มี signature ให้ตรวจ
  2. กันรายการซ้ำใน transaction เดียวกับการปรับยอด การเช็ค providerTransactionId แยกกับการ update ยอด (เช่นเช็คก่อนแล้วค่อยเปิด transaction) ยังคิดเงินซ้ำได้เมื่อ request ซ้ำเข้ามาพร้อมกัน ต้องมี unique constraint ในฐานข้อมูลด้วย
  3. รายการซ้ำตอบ 7 พร้อมยอดปัจจุบัน ไม่ใช่ตอบ 0 และไม่ใช่ error
  4. ยอดติดลบ ปฏิเสธด้วย 2 เฉพาะเมื่อ transferIn มากกว่ายอดที่มี และ ableNegativeBalance ไม่ใช่ true ถ้า AI ปฏิเสธทุกกรณีที่ยอดติดลบโดยไม่ดู ableNegativeBalance ถือว่าผิด
  5. ชื่อฟิลด์ตอบกลับ /check-balance ต้องมี username, balance, status_code และ /update-balance ต้องมี username, balanceBefore, balanceAfter, status_code
  6. รหัส status_code ตรงตารางในเอกสาร: 0 SUCCESS, 1 USER_NOT_FOUND, 2 INSUFFICIENT_BALANCE, 3 INVALID_REQUEST, 4 UNAUTHORIZED, 5 FORBIDDEN, 6 INTERNAL_SERVER_ERROR, 7 TRANSACTION_ALREADY_EXISTS, 8 TO_CANCEL_TRANSACTION_NOT_FOUND
  7. ตอบ 0 หลัง commit ถ้าโค้ดตอบก่อน commit แล้ว commit ล้ม ผู้เล่นจะได้ผลที่ไม่ได้บันทึก
  8. init-session อยู่ฝั่ง backend ถ้าเห็น Private Key ใน frontend หรือในโค้ดที่ส่งไป browser ให้ย้ายออกทันที

ตัวอย่างจุดที่ AI พลาดบ่อยในข้อ 2

javascript
// ผิด: เช็คซ้ำนอก transaction สอง request พร้อมกันผ่านทั้งคู่
if (await isProcessed(txId)) return reply(7);
await db.transaction(async (t) => { await applyBalance(t, body); await markProcessed(t, txId); });

// ถูก: ล็อกแถวกระเป๋า เช็คซ้ำ ปรับยอด และบันทึก id ใน transaction เดียว
await db.transaction(async (t) => {
  const wallet = await t.lockWallet(body.username);       // SELECT ... FOR UPDATE
  if (await t.isProcessed(txId)) return reply(7, wallet.balance);
  const after = await applyBalance(t, wallet, body);
  await t.markProcessed(txId);                            // unique constraint กันอีกชั้น
  return reply(0, wallet.balance, after);
});

หลังตรวจโค้ดแล้ว ทดสอบจริงด้วยหน้า Callback Test ในหลังบ้าน Neo ตามขั้นตอนใน เชื่อม Neo API แบบ Seamless ทีละขั้น ถ้า callback ผ่านในเครื่องแต่เกมจริงเล่นไม่ได้ทุกค่าย ให้ดู callback โดน Cloudflare บล็อก 403

เก็บ Private Key ให้พ้นจาก AI

Private Key ใช้ยืนยันตัวตนทั้งตอนคุณเรียก Neo API และตอน Neo API เรียก callback ของคุณ ใครได้ค่านี้ไปก็เรียก API ในนามบัญชีของคุณได้

  • อย่าวาง Private Key หรือ API key ลงในแชท prompt หรือไฟล์ที่แนบให้ AI ถ้าจะให้ AI ดูตัวอย่าง request ให้แทนค่าด้วย YOUR_PRIVATE_KEY
  • เก็บใน environment variable หรือ secret manager ไฟล์ .env ต้องอยู่ใน .gitignore
  • กันไม่ให้เครื่องมืออ่าน .env เอง: Cursor ใส่ .env ใน .cursorignore ส่วน Claude Code ตั้ง permission ปฏิเสธการอ่านไฟล์ .env ใน settings ของโปรเจกต์
  • อย่าให้ AI รันคำสั่งที่พิมพ์ค่า env ออกมา เช่น echo $NEO_PRIVATE_KEY หรือ printenv
  • ตรวจ log ของแอปว่าไม่ได้พิมพ์ header Authorization ออกมา
  • ถ้า Private Key เคยถูกวางลงแชทหรือ commit ไปแล้ว ให้ Reset Private Key ในหน้า บัญชีของฉัน ทันที แล้วอัปเดตค่าในทุกเครื่อง

FAQ

ใช้ llms-full.txt หรือ seamless.md ดี

ถ้ารู้แล้วว่าใช้แบบ Seamless ให้ใช้ seamless.md เพราะสั้นกว่าและตรงงาน ใช้ llms-full.txt เมื่ออยากให้ AI เห็นทั้ง Seamless, Transfer และ API จัดการสายงานในครั้งเดียว

AI บอกว่าต้องตรวจ signature ของ callback ต้องทำไหม

ไม่ต้อง เอกสารไม่ได้กำหนด signature การยืนยันว่า request มาจาก Neo API คือเทียบ header Authorization กับ Private Key ของคุณ ถ้าต้องการชั้นป้องกันเพิ่ม ขอรายการ IP Whitelist จากหัวสายหรือ Neo Support

โค้ดจาก AI ผ่าน test ของตัวเองแล้ว ต้องทดสอบอะไรอีก

รันหน้า Callback Test ในหลังบ้าน Neo กับเซิร์ฟเวอร์ที่มีโดเมนสาธารณะ แล้วเปิดเกมจริงด้วยผู้เล่นทดสอบ เดิมพันหนึ่งตา และดูว่ารายการขึ้นใน get-transaction-by-username พร้อม status เป็น SUCCESS

ติดปัญหาที่เอกสารไม่ได้ตอบ ถามใคร

ถาม Neo Support ทาง Telegram https://t.me/neosuperapi ส่ง request/response ที่ลบ Private Key ออกแล้ว พร้อม username และเวลาที่เกิดปัญหา ข่าวและประกาศของ Neo API ติดตามได้ที่ https://t.me/neoapihub

บทความอื่น

เชื่อม Neo API แบบ Seamless ทีละขั้น พร้อม checklist go-live

ขั้นตอนเชื่อม Neo API แบบ Seamless ตั้งแต่ Private Key, Callback URL, /check-balance, /update-balance, get-games, init-session ถึง checklist ก่อนเปิดจริง

Seamless กับ Transfer ต่างกันยังไง เลือกแบบไหนกับ Neo API

เทียบการเชื่อม Neo API แบบ Seamless (Single Wallet) กับ Transfer (Two Wallet) ว่าใครถือกระเป๋าเงิน ต้องสร้างอะไรบ้าง ใช้ endpoint ไหน ข้อดีข้อเสีย และวิธีเลือก

Callback โดน Cloudflare บล็อก 403 ทุกค่ายเล่นไม่ได้ แก้ยังไง

init-session สำเร็จแต่ทุกค่ายเดิมพันไม่ได้ ให้เช็ค Cloudflare หรือ WAF หน้า Callback URL ก่อน วิธียืนยันอาการ ตั้ง Skip rule หรือแยก subdomain และทดสอบซ้ำ

ปรับ RTP ค่าย _plus ผ่าน API ด้วย set-rtp และ init-session

ค่าย _plus ไหนปรับ RTP ได้ ไหนไม่ได้ เช็คด้วย canSetRtp และ canSetPreset แล้วตั้งด้วย set-rtp หรือส่ง rtp กับ init-session พร้อมตัวอย่าง request และ error