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

วิธีให้ AI เขียนโค้ดเชื่อม Neo API ให้ถูกตั้งแต่รอบแรก ส่งเอกสาร Markdown, prompt พร้อมใช้, จุดที่ต้องตรวจในโค้ด callback และการเก็บ Private Key ให้พ้นแชท

ให้ 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

## ทำไมต้องส่งเอกสารให้ 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 ต่างกันยังไง](/blog/seamless-vs-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 ทีละขั้น](/blog/seamless-integration-guide) ถ้า callback ผ่านในเครื่องแต่เกมจริงเล่นไม่ได้ทุกค่าย ให้ดู [callback โดน Cloudflare บล็อก 403](/blog/callback-403-cloudflare)

## เก็บ 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

---
Source: https://neoapihub.com/blog/integrate-with-ai
