ใช้ AI ช่วยเชื่อม Neo API กับ Claude Code, Cursor, ChatGPT
ให้ 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
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 แล้วอ้างถึงไฟล์นั้น
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 พร้อมใช้
แก้ส่วนที่อยู่ใน <...> ให้ตรงกับระบบของคุณ แล้ววางทั้งก้อน
อ่านเอกสาร 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 เขียน
อ่านโค้ดทีละข้อ อย่าดูแค่ว่ารันผ่าน
- Authorization มาก่อนทุกอย่าง ต้องเทียบ header
Authorizationกับค่าใน env ก่อน query ฐานข้อมูล ถ้า AI เทียบหลังอ่านยอด หรือข้ามการตรวจใน/check-balanceให้แก้ ถ้าเจอโค้ดตรวจ HMAC หรือ signature ให้ลบออก เพราะเอกสาร Neo API ไม่มี signature ให้ตรวจ - กันรายการซ้ำใน transaction เดียวกับการปรับยอด การเช็ค
providerTransactionIdแยกกับการ update ยอด (เช่นเช็คก่อนแล้วค่อยเปิด transaction) ยังคิดเงินซ้ำได้เมื่อ request ซ้ำเข้ามาพร้อมกัน ต้องมี unique constraint ในฐานข้อมูลด้วย - รายการซ้ำตอบ
7พร้อมยอดปัจจุบัน ไม่ใช่ตอบ0และไม่ใช่ error - ยอดติดลบ ปฏิเสธด้วย
2เฉพาะเมื่อtransferInมากกว่ายอดที่มี และableNegativeBalanceไม่ใช่trueถ้า AI ปฏิเสธทุกกรณีที่ยอดติดลบโดยไม่ดูableNegativeBalanceถือว่าผิด - ชื่อฟิลด์ตอบกลับ
/check-balanceต้องมีusername,balance,status_codeและ/update-balanceต้องมีusername,balanceBefore,balanceAfter,status_code - รหัส
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 - ตอบ
0หลัง commit ถ้าโค้ดตอบก่อน commit แล้ว commit ล้ม ผู้เล่นจะได้ผลที่ไม่ได้บันทึก init-sessionอยู่ฝั่ง backend ถ้าเห็น Private Key ใน frontend หรือในโค้ดที่ส่งไป browser ให้ย้ายออกทันที
ตัวอย่างจุดที่ AI พลาดบ่อยในข้อ 2
// ผิด: เช็คซ้ำนอก 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



