ข้อจำกัดการใช้งาน

บริการ NETPIE Feed เปิดให้ใช้ฟรีสาหรับผู้ใช้ทั่วไป ดั้งนั้นเพื่อแบ่งปันทรัพยากรกันอย่างเหมาะสม จะจากัดอัตราการเขียน Feed ต่อ API Key ไว้ที่ 4 ครั้งในเวลาประมาณ 60 วินาที หรือเฉลี่ยให้เขียนได้ 15 วินาที ต่อ 1 จุด และในเบื้องต้นจะให้ระยะเวลาเก็บข้อมูลหนึ่งปี การเขียนข้อมูลลงใน Feed อาจจะเขียนผ่านทาง Microgear หรือ Client หลายตัวเพียงแต่ Quota ของการเขียนก็จะแบ่งกันไประหว่าง Client ที่ใช้ API key เดียวกัน ในส่วนของการอ่านค่านั้น จะจำกัดการเรียก API ไว้ที่ 5 ครั้งใน 5 วินาที การเรียก API แต่ละครั้ง ถ้าอ่านหรือเขียนสำเร็จจะมีสถานะตอบกลับ ตามตัวอย่างนี้

• {“code”:200,”message”:”Update OK”} หมายความว่า ทำงานสาเร็จ
• {“code”:401,”message”:”Unauthorized”} หมายความว่า API Key ที่ใช้ไม่มีสิทธิ์เข้าถึง Feed ดังกล่าว
• {“code”:429,”message”:”Rate limit exceeded, wait 2.286758 seconds”} หมายความว่า มีการเรียกใช้งานเกินอัตราที่กำหนด

นอกจากสถานะตอบกลับแล้ว ในกรณีของการเรียกผ่าน REST API ส่วนของ Reply ก็จะมี HTTP Header แนบกลับมาด้วยเพื่อบอกสถานะเกี่ยวกับ Rate Limit และ Quota ที่ยังเหลืออยู่ ซึ่งอาจเป็นประโยชน์ต่อนักพัฒนา ตัวอย่างเช่น หากเรียก API สาหรับอ่านข้อมูลจาก Feed จานวน 5 ครั้งติดกัน ครั้งสุดท้ายจะเห็น Header ดังนี้

X-RateLimit-Interval: 5
X-RateLimit-Quota: 5
X-RateLimit-Minimum-Wait: 0
X-RateLimit-ToWait: 1.570335

เป็นการบอกว่าต้องรออีกประมาณ 1.57 วินาที จึงจะสามารถ เรียก API เดิมซ้าอีกครั้งได้ ซึ่งหากผู้ใช้ไม่รอและเรียก API ต่อทันที ค่าที่ Reply ครั้งถัดไปจะมีสถานะเป็น 429 Rate limit exceeded