StocksTrader API ช่วยให้สามารถโต้ตอบกับแพลตฟอร์มการเทรดได้ แต่ข้อผิดพลาดอาจเกิดขึ้นได้หากคำขอไม่ได้ถูกจัดรูปแบบอย่างถูกต้อง บทความนี้อธิบายรหัสข้อผิดพลาดที่พบบ่อยที่สุด ได้แก่ 400 Bad Request และ 401 Unauthorized พร้อมแนวทางแก้ไข

คู่มือนี้จะช่วยให้คุณระบุและแก้ไขข้อผิดพลาดของ API ได้อย่างรวดเร็ว

รหัสข้อผิดพลาดที่พบบ่อย

1. 400 — Bad request

หมายความว่า: คำขอมีข้อผิดพลาดเนื่องจาก URL ไม่ถูกต้อง มีพารามิเตอร์ที่ขาดหายหรือไม่ถูกต้อง หรือรูปแบบข้อมูลไม่ถูกต้อง

ตัวอย่าง:

• ใช้ /api/v1/logout/account แทนที่ /api/v1/logout ที่ถูกต้อง
• ขาดฟิลด์ที่จำเป็น เช่น ticker, volume, side หรือ type ในคำขอ POST ไปยัง /api/v1/accounts/{account_id}/orders
• ใส่ account_id หรือ ticker ที่ไม่ถูกต้องในคำขอ เช่น /api/v1/accounts/{account_id}/instruments/{ticker}

วิธีแก้:

• ตรวจสอบ URL: ให้ตรงตามเอกสาร API เช่น ใช้ /api/v1/logout แทน /api/v1/logout/account
• ตรวจสอบพารามิเตอร์: ตรวจสอบให้แน่ใจว่ามีพารามิเตอร์ที่จำเป็นทั้งหมด เช่น ticker, volume, side และ type ในคำขอ POST
• ตรวจสอบรูปแบบข้อมูล: ให้แน่ใจว่าข้อมูลที่ส่งมาอยู่ในรูปแบบที่คาดหวัง
• ดูข้อความตอบกลับ: ตรวจสอบฟิลด์ msg ในการตอบกลับเพื่อดูรายละเอียดเกี่ยวกับข้อผิดพลาด

2. 401 — Unauthorized

หมายความว่า: ไม่มีโทเคนการอนุญาต หรือโทเคนไม่ถูกต้อง

ตัวอย่าง:

• เข้าถึง /api/v1/accounts โดยไม่มี Bearer token
• ใช้โทเคนที่หมดอายุหรือไม่ถูกต้อง

วิธีแก้:

• แนบโทเคน: เพิ่มส่วนหัว Authorization ในคำขอ
• ตรวจสอบโทเคน: หากโทเคนหมดอายุ ให้สร้างใหม่ผ่าน Web Terminal ของ StocksTrader
• ตรวจสอบสิทธิ์: ให้แน่ใจว่าโทเคนเป็นของบัญชีที่มีสิทธิ์เข้าถึง API ที่ร้องขอ

คำแนะนำทั่วไป

• อ้างอิงจากเอกสาร: ตรวจสอบ endpoint, พารามิเตอร์ และรูปแบบข้อมูลจาก API specification
• บันทึกคำขอและการตอบกลับ: จดบันทึกรายละเอียดของคำขอและการตอบกลับ รวมถึงฟิลด์ msg
• ทดสอบล่วงหน้า: ใช้เครื่องมืออย่าง Postman เพื่อทดสอบก่อนใช้งานจริง
• ติดต่อฝ่ายสนับสนุน: หากยังพบปัญหา โปรดติดต่อฝ่ายสนับสนุนและระบุรายละเอียดของคำขอ (URL, ข้อมูล, และการตอบกลับ)

ตัวอย่าง: การแก้ไขข้อผิดพลาด 400

ปัญหา: คุณได้รับรหัส 400 เมื่อส่งคำขอ POST ไปยัง /api/v1/logout/account

แนวทางแก้:

1. ตรวจสอบเอกสาร: endpoint ที่ถูกต้องคือ /api/v1/logout

2. อัปเดต URL เป็น https://api.stockstrader.com/api/v1/logout

3. ตรวจสอบว่าใช้คำขอแบบ POST พร้อมส่วนหัว Authorization

4. ลองส่งคำขออีกครั้ง

ตัวอย่าง: การแก้ไขข้อผิดพลาด 401

ปัญหา: คุณได้รับรหัส 401 เมื่อส่งคำขอ GET ไปยัง /api/v1/accounts เพื่อดึงรายการบัญชีของคุณ

แนวทางแก้:

1. ตรวจสอบส่วนหัว: ให้แน่ใจว่ามี Authorization

2. หากไม่มี ให้เพิ่มเข้าไป หากโทเคนหมดอายุ ให้สร้างใหม่จาก Web Terminal

3. ตรวจสอบว่าโทเคนนั้นมีสิทธิ์เข้าถึง /api/v1/accounts

4. ลองส่งคำขอใหม่อีกครั้งด้วยโทเคนที่ถูกต้อง