Endpoints αναλύσεων

Αντλήστε τα αναλυτικά σας δεδομένα προγραμματικά. Όλα τα σημεία ανάλυσης απαιτούν έλεγχο ταυτότητας JWT, ανήκουν σε ακριβώς ένα κλειδί API και δέχονται την περίοδο ως `days` (1–365, προεπιλογή 30)· το `form_key` περιορίζει σε μία φόρμα.

Base URL: https://api.silentshield.io

GET/api/v1/keys/{id}/analytics/summary

Λάβετε επισκόπηση αιτημάτων, ετυμηγοριών και τάσεων για μια δεδομένη περίοδο.

Parameters: ?days=30&form_key=contact

Response:

{"period_days": 30, "overview": {...}, "timeline": [...], "verdicts": [...], "pages": [...], "devices": [...], "browsers": [...], "reasons": [...], "blocks": {...}, "score_distribution": [...]}

GET/api/v1/keys/{id}/analytics/timeline

Λάβετε αριθμούς αιτημάτων ομαδοποιημένους ανά χρονικό διάστημα (ώρα, ημέρα, εβδομάδα).

Parameters: ?days=7&form_key=contact

Response:

[{"date": "2025-01-01", "total": 1800, "human": 1620, "suspicious": 110, "bot": 70}, ...]

GET/api/v1/keys/{id}/analytics/verdicts

Λάβετε λεπτομερή κατανομή ετυμηγοριών με βαθμολογίες.

Parameters: ?days=30&form_key=contact

Response:

{"distribution": {"human": 89.6, "suspicious": 6.4, "bot": 4.0}, "avgScore": 0.82}

GET/api/v1/keys/{id}/analytics/devices

Λάβετε κατανομή συσκευών και προγραμμάτων περιήγησης.

Parameters: ?days=30&form_key=contact

Response:

{"devices": {"desktop": 65.2, "mobile": 28.1, "tablet": 4.2, "unknown": 2.5}, "browsers": {"Chrome": 58.3, "Safari": 22.1, "Firefox": 12.4, "Edge": 5.8, "Other": 1.4}}