เพื่อให้ระบบมีเสถียรภาพและสามารถให้บริการผู้ใช้งานทุกคนได้อย่างมีประสิทธิภาพ
API นี้มีการกำหนด Rate Limiting และ Concurrency Control

หาก Client ส่ง request เกินกว่าข้อจำกัดที่กำหนด ระบบจะตอบกลับด้วย

HTTP 429 Too Many Requests

Limit Summary

Note: Concurrency limit จะนับเฉพาะ request ที่ยังประมวลผลไม่เสร็จ หรือยังไม่ได้รับ response เท่านั้น

Note: GetConcurrencyLimitByUserToken และ PostConcurrencyLimitByUserToken มีผลเฉพาะ endpoint ที่ระบบกำหนดให้ใช้ policy นี้เท่านั้น ไม่ใช่ทุก endpoint ของระบบ

Rate Limit Policy

Rate limit ใช้เพื่อจำกัดจำนวน request ภายในช่วงเวลาที่กำหนด

Client Token Scope

หมายเหตุเรื่อง Scope: เนื่องจาก endpoint นี้ใช้สำหรับขอ Client Token ก่อนที่ client จะมี token ใดๆ ระบบจึงไม่สามารถจำกัดตาม token ได้ และใช้ IP Address ของผู้เรียก เป็น scope ในการนับจำนวน request แทน ผลคือ IP เดียวกันที่ยิงหลาย request (เช่นอยู่หลัง NAT/proxy เดียวกัน) จะถูกนับรวมกันในโควต้าเดียว

Example

หาก client ส่ง request มากกว่า 10 ครั้งภายใน 1 นาที (จาก IP เดียวกัน)
ระบบจะตอบกลับ

HTTP 429 Too Many Requests

ตัวอย่าง response

{
  "error": "RATE_LIMITED",
  "type": "rate",
  "policy": "ClientTokenLimit",
  "retryAfterSeconds": 60,
  "message": "Too many requests. Please retry later.",
  "path": "/api/v1/clienttoken",
  "timestamp": "2026-03-12T14:20:00+07:00"
}

Concurrency Limit Policy

Concurrency limit คือการจำกัดจำนวน request ที่กำลังประมวลผลพร้อมกัน (in-flight requests)

Concurrency limit ถูกกำหนด ต่อ User Token และมีผลเฉพาะ endpoint ที่ระบบกำหนดให้ใช้ policy นี้เท่านั้น (ดูตาราง Limit Summary)

ความหมาย

• สำหรับ endpoint ที่ใช้ policy นี้ สามารถมี GET requests ที่กำลังประมวลผลพร้อมกันได้สูงสุด 20 requests ต่อ User Token
• สำหรับ endpoint ที่ใช้ policy นี้ สามารถมี POST requests ที่กำลังประมวลผลพร้อมกันได้สูงสุด 10 requests ต่อ User Token

หากมี request ใหม่เข้ามาในขณะที่จำนวน concurrent request เกินกว่าที่กำหนด
ระบบจะปฏิเสธ request นั้นทันที

Concurrency Scope

Concurrency limit ถูกกำหนด ต่อ User Token

หมายความว่า

• User Token แต่ละตัวมี limit ของตัวเอง
• การใช้งานของ token หนึ่งจะไม่กระทบ token อื่น

Example

หาก

• token-A ยิง GET 20 requests พร้อมกัน
• token-B ยังสามารถยิง GET ได้อีก 20 requests

เมื่อ request ถูกปฏิเสธเนื่องจากเกิน limit ระบบจะตอบกลับเป็น JSON ดังนี้

HTTP 429 Too Many Requests

ตัวอย่าง response

{
  "error": "RATE_LIMITED",
  "type": "concurrency",
  "policy": "GetConcurrencyLimitByUserToken",
  "retryAfterSeconds": null,
  "message": "Too many concurrent requests. Please wait until the previous request completes before retrying.",
  "path": "/api/v1/resource",
  "timestamp": "2026-03-12T14:20:00+07:00"
}

Financial Reports: Trial Balance (Combined Limit)

GET /api/v1/FinancialReports/trialbalance มีข้อจำกัดเข้มงวดกว่า endpoint GET ทั่วไป เนื่องจากเป็น report ที่ใช้ทรัพยากรประมวลผลสูง โดยถูกจำกัดด้วย สองนโยบายพร้อมกัน ต่อ User Token เดียวกัน:

ความหมาย

• User Token เดียวกันเรียก endpoint นี้ได้ไม่เกิน 10 ครั้งต่อนาที
• และในเวลาเดียวกัน เรียกพร้อมกันได้สูงสุดเพียง 1 request เท่านั้น (request ที่ 2 ที่ยิงเข้ามาก่อน request แรกจะประมวลผลเสร็จ จะถูกปฏิเสธทันที)

Limit นี้แยกต่างหากจาก GetConcurrencyLimitByUserToken (20 concurrent) ที่ใช้กับ GET endpoint ทั่วไป — endpoint นี้ไม่ได้ใช้ policy 20 concurrent แต่ใช้ policy เฉพาะของตัวเองแทน