الجلسات

استرجاع جلسات المستخدم

تُرجع قائمة الجلسات الخاصة بمستخدم معيّن تم تعريفه عبر دالة JavaScript المسماة tracker.setUserID. تقتصر النتائج على 50 جلسة لكل طلب.

الطريقة

GET

الرابط

/api/v1/:projectKey/users/:userId/sessions

المعاملات

الاسم	النوع	الوصف
projectKey	string	معرّف المشروع الذي تتعقبه (مطلوب)
userId	string	معرّف المستخدم الخاص بك، الذي يتم تعيينه عبر `tracker.setUserID` (مطلوب)
start_date	epoch (ms)	تاريخ البداية الذي تُصفَّى الجلسات اعتبارًا منه
end_date	epoch (ms)	تاريخ النهاية الذي تُصفَّى الجلسات حتى بلوغه

ترويسات الطلب

Authorization: {YOUR_ORGANIZATION_API_KEY}: يمكن العثور على المفتاح في ‘Preferences’ > ‘Account’ > ‘Organization API Key’.

رموز الحالة

200: يتم إرسال الاستجابة بصيغة JSON في الجسم

مثال على الطلب

curl -X GET \
  https://openreplay.example.com/api/v1/3sWXSsqHgSKnE87YkNJK/users/mickael@openreplay.com/sessions \
  -H 'content-type: application/json' \
  -H 'Authorization: {YOUR_ORGANIZATION_API_KEY}'

مثال على الاستجابة

{
  "data": [
    {
      "projectId": 1,
      "sessionId": "4813018042986240",
      "userUuid": "15bd70f6-aedf-4544-8ae6-57eb66398e94",
      "userId": "mickael@openreplay.com",
      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.77 Safari/537.36",
      "userOs": "Mac OS X",
      "userBrowser": "Chrome",
      "userDevice": "",
      "userCountry": "IN",
      "startTs": 1623440822825,
      "duration": 12779,
      "eventsCount": 1,
      "pagesCount": 1,
      "errorsCount": 0
    },
    {
      "projectId": 1,
      "sessionId": "4813023023591169",
      "userUuid": "15bd70f6-aedf-4544-8ae6-57eb66398e94",
      "userId": "mickael@openreplay.com",
      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.77 Safari/537.36",
      "userOs": "Mac OS X",
      "userBrowser": "Chrome",
      "userDevice": "",
      "userCountry": "IN",
      "startTs": 1623440902620,
      "duration": 18226,
      "eventsCount": 6,
      "pagesCount": 5,
      "errorsCount": 0
    }
  ]
}