ได้รับ 403/401 (สิทธิ์และสโคป)

ความแตกต่างระหว่าง 401 กับ 403

กรณีทั่วไปของ 401 และการรับมือ

• โทเคนหมดอายุ(expired_token)→ ต่ออายุด้วย refresh token
• โทเคนถูกเพิกถอนแล้ว(ผู้ใช้ยกเลิกการเชื่อมต่อ เป็นต้น)→ ฟลว์การอนุมัติซ้ำ
• รูปแบบของ Authorization header ไม่ถูกต้อง → Bearer (มีช่องว่างครึ่งความกว้าง)+ โทเคน
• ใช้ environment ผิด(ใช้โทเคน production ใน staging)→ ตรวจสอบ environment

กรณีทั่วไปของ 403 และการรับมือ

• สโคปไม่เพียงพอ(insufficient_scope)→ เพิ่มสโคปที่จำเป็นแล้วอนุมัติซ้ำ
• ไม่มีสิทธิ์เข้าถึงร้านค้า → ตรวจสอบว่าไม่ได้เรียกทรัพยากรของร้านค้าอื่นนอกจากร้านที่แอปเชื่อมต่อไว้
• สโคปประเภท User ยังไม่ผ่านการตรวจสอบ(app_not_approved)→ ยื่นขอตรวจสอบ (ดูบทความแยก)
• สิทธิ์ของบทบาทไม่เพียงพอ → ผู้ใช้ที่เชื่อมต่อในตอนนั้นไม่มีบทบาทที่จำเป็น (เช่น เจ้าของ)
• ข้อจำกัดของแพลน(plan_limit_exceeded)→ อัปเกรดแพลนของฝั่งร้านค้า

ขั้นตอนการแยกแยะสาเหตุ

1. ตรวจสอบ error.code และ message ใน response
2. บันทึก X-RR-Request-Id ลง log
3. หากเป็น 401 ให้เรียก /v1/me เพื่อตรวจสอบว่าโทเคนเองยังใช้งานได้หรือไม่ (ถ้าสำเร็จแสดงว่าโทเคนโอเค หากขั้นต่อไปเป็น 403 แสดงว่าเป็นปัญหาสิทธิ์)
4. หากเป็น 403 ให้ตรวจสอบ scope ที่อยู่ในโทเคนปัจจุบัน (/v1/oauth/introspect)
5. หากไม่มีสโคปที่จำเป็นอยู่ ให้อนุมัติซ้ำ

วิธีตรวจสอบสโคป

curl -X POST https://receiptroller.io/oauth/introspect \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "token=$ACCESS_TOKEN&client_id=$CLIENT_ID&client_secret=$SECRET"

→ {
  "active": true,
  "scope": "store.read receipt.read",
  "client_id": "...",
  "exp": 1745740001
}

คู่มือที่เกี่ยวข้อง

• รายการสโคป OAuth
• สโคปประเภท User ส่งคืน app_not_approved
• กลับไปที่ Developer Help Top