ดึงค่า RPM สูงสุดขององค์กร

ดึงค่า RPM (จำนวนคำขอต่อหนึ่งนาที) สูงสุดขององค์กรตามช่วงเวลา: นำจำนวนคำขอจากทุก Agent ขององค์กรในนาทีเดียวกันมาบวกกัน จากนั้นเลือกค่านาทีสูงสุดในช่วงเวลา พร้อมกลับเวลาที่เกิดจุดสูงสุด ค่า RPM เฉลี่ย และจำนวนคำขอทั้งหมด

หมายเหตุ: สามารถสอบถามข้อมูลได้สูงสุด 31 วัน; นับเฉพาะช่องทางของพื้นที่พัฒนา ขอบเขตการนับตาม "เกณฑ์การนับ" ด้านล่าง

วิธีการเรียก

GET

URL การเรียก

https://api-${endpoint}.gptbots.ai/v1/org/stat/rpm

การตรวจสอบการเรียก

ใช้บัญชี DevKey / DevSecret ระดับบัญชี ด้วยการยืนยัน Basic: Authorization: Basic ${BASIC_TOKEN} โดยที่ ${BASIC_TOKEN} เป็นการเข้ารหัส Base64 ของ DevKey:DevSecret

บัญชีที่เรียกต้องเป็นสมาชิกขององค์กรที่สอดคล้องกับ org_id และมีสิทธิ์ "ดูปริมาณการใช้งาน" (Owner และผู้ดูแลขององค์กรมีสิทธิ์โดยค่าเริ่มต้น)
กรุณาเรียก URL ตามศูนย์ข้อมูลที่องค์กรอยู่ โดย ${endpoint} ใช้ค่า region ที่ได้จาก การค้นหารายการองค์กร (SG → sg, TH → th, JP → jp). หากเรียกจากศูนย์ข้อมูลอื่นจะแสดงข้อความ "ไม่ใช่สมาชิกองค์กรนี้"

ความถี่ในการเรียก

DevKey แต่ละชุดเรียก API นี้ได้สูงสุด 60 ครั้งต่อหนึ่งนาที
การเรียกแต่ละครั้งจะถูกนับรวมในโควต้าต่อหนึ่งนาทีของ "API ประเภทสถิติ" ขององค์กร และใช้ร่วมกับการเรียก API ของ Agent
ข้อมูลจะอัปเดตทุกชั่วโมง การเรียกซ้ำในชั่วโมงเดียวกันจะได้ผลลัพธ์เดียวกัน แนะนำให้เรียกทุกชั่วโมง

คำขอ

ตัวอย่างคำขอ

curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/org/stat/rpm?org_id=${org_id}&start_time=1788192000000&end_time=1788796800000' \ -H 'Authorization: Basic ${BASIC_TOKEN}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/org/stat/rpm?org_id=${org_id}&start_time=1788192000000&end_time=1788796800000' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

บล็อกโค้ดนี้ในหน้าต่างลอย

ส่วนหัวคำขอ

ฟิลด์	ประเภท	คำอธิบาย
Authorization	Basic ${BASIC_TOKEN}	ใช้ `DevKey:DevSecret` Base64 หลังจากนั้นเป็น Basic Token

พารามิเตอร์คำขอ

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
org_id	String	ใช่	รหัสองค์กร
start_time	Long	ใช่	เวลาที่เริ่มต้น เป็น timestamp แบบมิลลิวินาที ปรับลงไปยังชั่วโมงที่สมบูรณ์
end_time	Long	ใช่	เวลาสิ้นสุด (ไม่รวม) เป็น timestamp แบบมิลลิวินาที ปรับขึ้นไปยังชั่วโมงที่สมบูรณ์ ช่วงเวลาที่ปรับแล้วต้องไม่เกิน 31 วัน

การตอบกลับ

ตัวอย่างการตอบกลับ

{ "code": 0, "message": "OK", "data": { "org_id": "65f0c2a1b4e8d93a1c7e5b20", "range_start": 1788192000000, "range_end": 1788796800000, "data_until": 1788793200000, "data_since": 1786125600000, "peak_rpm": 186, "peak_at": 1788512460000, "avg_rpm": 12.40, "total_requests": 2083411 } }

                      
                      {
    "code": 0,
    "message": "OK",
    "data": {
        "org_id": "65f0c2a1b4e8d93a1c7e5b20",
        "range_start": 1788192000000,
        "range_end": 1788796800000,
        "data_until": 1788793200000,
        "data_since": 1786125600000,
        "peak_rpm": 186,
        "peak_at": 1788512460000,
        "avg_rpm": 12.40,
        "total_requests": 2083411
    }
}

บล็อกโค้ดนี้ในหน้าต่างลอย

การตอบสนองที่สำเร็จ

ฟิลด์	ประเภท	คำอธิบาย
org_id	String	รหัสองค์กร
range_start	Long	จุดเริ่มต้นของช่วงสถิติจริง: `start_time` จัดแนวลงไปที่ชั่วโมงที่ครบเวลาในรูปแบบ timestamp มิลลิวินาที
range_end	Long	จุดสิ้นสุดของช่วงสถิติจริง (ไม่รวม): `end_time` จัดแนวขึ้นไปที่ชั่วโมงที่ครบเวลาในรูปแบบ timestamp มิลลิวินาที
data_until	Long	ข้อมูลถูกสถิติไปถึงเวลานี้ (timestamp มิลลิวินาที) ส่วนที่อยู่ในช่วงหลังเวลานี้ยังไม่มีข้อมูล
data_since	Long	RPM ขององค์กรเริ่มมีข้อมูลตั้งแต่ชั่วโมงเต็มใด (timestamp มิลลิวินาที ทุกองค์กรในศูนย์ข้อมูลเดียวกันเหมือนกัน ประมาณ 31 วันก่อนเปิดใช้งานฟังก์ชัน) ส่วนที่อยู่ในช่วงก่อนเวลานี้ไม่มีข้อมูล; ถ้าไม่มีข้อมูลเลยคือ `null`
peak_rpm	Long	RPM สูงสุด: จำนวนคำขอรวมในหนึ่งนาทีของ Agent ทั้งหมดในองค์กร ช่วงเวลาที่มากที่สุด
peak_at	Long	จุดเริ่มต้นของนาทีที่มีจุดสูงสุด (timestamp มิลลิวินาที) ถ้ามีหลายช่วงเวลาที่เท่ากัน ให้เอานาทีแรกภายในช่วง; ถ้าไม่มีคำขอในช่วงคือ `null`
avg_rpm	Number	RPM เฉลี่ย: จำนวนคำขอทั้งหมด ÷ จำนวนของนาทีที่มีคำขอ, เก็บ 2 ตำแหน่งทศนิยม
total_requests	Long	จำนวนคำขอทั้งหมดในช่วงเวลานั้น

การตอบสนองที่ล้มเหลว

ฟิลด์	ประเภท	คำอธิบาย
code	Integer	รหัสข้อผิดพลาด
message	String	รายละเอียดข้อผิดพลาด

รหัสข้อผิดพลาด

สถานะ HTTP จะเป็นตัวเลข 3 หลักแรกของรหัสข้อผิดพลาด เช่น 40000 ตรงกับ 400, 40100 ตรงกับ 401, 403132 ตรงกับ 403

รหัสข้อผิดพลาด	คำอธิบาย
40000	ข้อผิดพลาดของพารามิเตอร์ เช่น ขาดพารามิเตอร์ที่จำเป็น หรือค่าพารามิเตอร์ไม่ถูกต้อง
40001	เรียกใช้บ่อยเกินไป: กุญแจนักพัฒนานี้เกินขีดจำกัดต่อหนึ่งนาทีของ API นี้
40008	เกินขีดจำกัดต่อหนึ่งนาทีของแพ็กเกจองค์กร "API ประเภทสถิติ"
40010	API ปิดชั่วคราว กรุณาลองใหม่ภายหลัง
40100	ไม่มีสิทธิ์: ขาดสิทธิ์ในการดูการใช้งาน
40105	ไม่ใช่สมาชิกขององค์กรนี้ หรือเรียกไปยังที่อยู่ของศูนย์ข้อมูลอื่น
40324	DevKey หรือ DevSecret ไม่ถูกต้อง
403132	ช่วงเวลาที่ไม่ถูกต้อง: เวลาเริ่มต้นไม่ก่อนเวลาสิ้นสุด หรือเกินช่วงการค้นหาสูงสุด

เกณฑ์การนับสถิติ

คำขอ: ข้อความคำถามที่ผู้ใช้ส่ง พร้อมกับข้อผิดพลาดในการสนทนา (รวมทั้งคำขอที่ถูกปฏิเสธเพราะเกินความถี่การเรียก) ซึ่งสอดคล้องกับ "Agent Insights → คำขอต่อวินาที" ในคอนโซล มันไม่ใช่จำนวนการขอ HTTP และอาจนับต่างจากการจำกัดปริมาณตามแพ็กเกจ
ขอบเขตการนับสถิติ: นับเฉพาะคำขอของ Agent ในพื้นที่พัฒนาบนช่องทางพื้นที่พัฒนา รวมถึง API, หน้าแชร์, การฝังเว็บ, ส่วนประกอบฟอง, LiveDesk และช่องทางส่งข้อความทันทีและโทรศัพท์ต่างๆ; ไม่รวมการพรีวิวดีบัก, Workflow (รวมถึงการเรียก Workflow API ที่ถูกปฏิเสธเพราะเกินความถี่), การค้นหา AI ในเวิร์กสเปซ และการใช้ Agent ที่เผยแพร่ในเวิร์กสเปซ
ขอบเขตข้อมูล: มีข้อมูลตั้งแต่ 31 วันก่อนเปิดใช้ฟีเจอร์ ช่วงก่อนหน้านั้นอิงตาม data_since
ความถี่ในการอัปเดต: ข้อมูลสถิติในแต่ละชั่วโมงเป็นรอบชั่วโมง มีความล่าช้าประมาณ 1 ชั่วโมง อิงตาม data_until
ความแตกต่างกับหน้าคอนโซล "องค์กร → การใช้งาน → RPM": คอนโซลแสดงตาม 24 ชั่วโมงในวันเดียว ขณะที่ API นี้ส่งค่าจุดสูงสุดเดียวและเวลาเกิดเหตุของช่วงนั้น