זהו דוח לוח מחוונים בגרסת SQL עבור בקשות API מאוחדות.
דוח זה מציג סטטיסטיקות שימוש ב-API לפי תאריך, ועוקב אחר בקשות API רגילות ובקשות API של משתמשים. דוח זה עוזר לך לנטר את דפוסי השימוש ב-API במופע ה-Discourse שלך לאורך זמן. הוא מבחין בין בקשות API רגילות לבקשות API של משתמשים, ומציג את שתיהן בנפרד יחד עם הספירה הכוללת המשולבת.
הנתונים מקורם בטבלה application_requests שעוקבת אחר סוגי בקשות שונים במערכת. עבור שימוש ב-API, אנו מתמקדים בסוגי הבקשות 11 (API רגיל) ו-12 (API משתמש).
-- [params]
-- date :start_date = 2023-01-01
-- date :end_date = 2025-12-31
SELECT
ar.date,
-- בקשות API
SUM(CASE WHEN ar.req_type = 11 THEN ar.count ELSE 0 END) AS api,
SUM(CASE WHEN ar.req_type = 12 THEN ar.count ELSE 0 END) AS user_api,
-- סך כל בקשות ה-API
SUM(CASE WHEN ar.req_type IN (11, 12) THEN ar.count ELSE 0 END) AS total_api_requests
FROM
application_requests ar
WHERE
ar.date BETWEEN :start_date AND :end_date
GROUP BY
ar.date
ORDER BY
ar.date DESC
פרמטרים:
- השאילתה מקבלת שני פרמטרים,
:start_dateו-:end_date, המגדירים את טווח התאריכים עבור הדוח. שני פרמטרי התאריך מקבלים את פורמט התאריךYYYY-MM-DD.
תוצאות
- date: תאריך ספירות הבקשות
- api: ספירת בקשות API רגילות (req_type = 11)
- user_api: ספירת בקשות API של משתמשים (req_type = 12)
- total_api_requests: סכום כל בקשות ה-API
מה ההבדל בין בקשות API רגילות לבקשות API של משתמשים?
- בקשות API רגילות (req_type = 11): אלו הן קריאות API למערכת שאינן דורשות אימות משתמש. הן כוללות נקודות קצה ציבוריות של API, אינטגרציות מערכת, או שירותי צד שלישי הניגשים לנתונים ציבוריים.
- בקשות API של משתמשים (req_type = 12): אלו הן קריאות API שבוצעו עם אימות משתמש, המייצגות בדרך כלל פעולות שבוצעו בשם משתמשים ספציפיים ודורשות שימוש במפתח API.
תוצאות לדוגמה
| date | api | user_api | total_api_requests |
|---|---|---|---|
| 2023-09-15 | 34,582 | 7,249 | 41,831 |
| 2023-09-14 | 32,104 | 6,893 | 38,997 |
| 2023-09-13 | 33,756 | 7,122 | 40,878 |
| 2023-09-12 | 35,122 | 8,562 | 43,684 |
| 2023-09-11 | 36,475 | 9,234 | 45,709 |
| 2023-09-10 | 12,563 | 3,298 | 15,861 |
| 2023-09-09 | 10,782 | 2,982 | 13,764 |
| 2023-09-08 | 33,892 | 7,456 | 41,348 |
| 2023-09-07 | 31,765 | 7,120 | 38,885 |
| 2023-09-06 | 32,451 | 7,321 | 39,772 |