توثيق API — GroupResearch
للوصول إلى بيانات التجارب برمجياً. يتطلب خطة Team وعُمر API key.
المصادقة
أضف مفتاحك في header لكل طلب:
Authorization: Bearer grk_your_key_here
الحد الأقصى: 100 طلب/ساعة لكل مفتاح
نقطة البيانات المجمّعة
GET
https://groupresearch.net/api/v1/data/experiments/{slug}/aggregatesيُرجع إحصاءات مجمّعة (متوسط، min، max) لكل سؤال في التجربة.
معاملات الاستعلام (اختيارية)
| Param | الوصف | مثال |
|---|---|---|
| from | تاريخ البداية | 2025-01-01 |
| to | تاريخ النهاية | 2025-12-31 |
مثال على الاستجابة
{
"experiment": {
"slug": "sleep-quality",
"title_en": "Sleep Quality Experiment",
"title_ar": "تجربة جودة النوم",
"duration_days": 21
},
"stats": {
"total_enrollments": 842,
"completed": 318
},
"aggregates": {
"sleep_hours": { "count": 5291, "avg": 6.8, "min": 2, "max": 12 },
"energy_level": { "count": 5291, "avg": 6.2, "min": 1, "max": 10 },
"felt_rested": { "count": 5291, "true_count": 3104 }
},
"period": "all-time"
}احصل على مفتاح API الآن
إدارة مفاتيح API