பொது API & API விசைகள்

உங்கள் பணியிடத்தை நிரல் வழியாக அணுகுங்கள் — திட்டங்கள், அமர்வுகள், தனிப்பயன் நிகழ்வுகள், பிரிவுகளைப் படித்து, அமர்வுகளுடன் வாடிக்கையாளர் ID-களை இணைக்கலாம் — பணியிடத்திற்கு உட்பட்ட API விசைகளால் பாதுகாக்கப்படுகிறது.

1. கண்ணோட்டம்

உங்கள் பணியிடத்திலிருந்து உங்கள் சொந்த டாஷ்போர்டுகள், தரவுக் கிடங்கு அல்லது உள் கருவிகளுக்குத் தரவைப் பெற MousePlayer API உதவுகிறது. அமர்வுகளுடன் வாடிக்கையாளர் ID-களை இணைப்பதைத் தவிர (identify; எழுதும் அனுமதியுள்ள விசை தேவை; விசை அனுமதிகளைப் பார்க்கவும்), இது படிப்பதற்கு மட்டும்: API மூலம் எந்தத் தரவையும் மாற்றவோ நீக்கவோ முடியாது.

  • அடிப்படை URL: https://www.mouseplayer.com/api/v1/
  • அனைத்து பதில்களும் JSON வடிவில் இருக்கும்.
  • ஒவ்வொரு கோரிக்கையும் API விசையால் அங்கீகரிக்கப்பட்டு, அந்த விசைக்குரிய பணியிடத்திற்குத் தானாக வரம்பிடப்படும் — ஒரு பணியிடத்தின் விசையால் மற்றொரு பணியிடத்தின் தரவைத் தவறுதலாகக்கூட பார்க்க முடியாது.
  • முழு அமர்வுப் பதிவு (மவுஸ் அசைவுகள், DOM நிலைப்படங்கள்) API வழியாக வழங்கப்படாது . அமர்வு மெட்டாடேட்டா, பக்கப் பார்வைகள், தனிப்பயன் நிகழ்வுகள், பிரிவுகள் கிடைக்கும் — மூலப் பதிவுத் தரவை இடமாற்றாமல் அறிக்கைகளையும் டாஷ்போர்டுகளையும் உருவாக்கப் போதுமானவை.

2. அங்கீகாரம்

உங்கள் கணக்கு மெனுவில் API விசைகள் என்பதில் API விசைகளை உருவாக்கி நிர்வகிக்கலாம் (/api-keys). பணியிட உரிமையாளர்களும் நிர்வாகிகளும் மட்டுமே விசைகளை உருவாக்கவோ திரும்பப்பெறவோ முடியும்.

உங்கள் விசையை ரகசியமாக வைத்திருங்கள். உங்கள் பணியிடத்தில் உள்ள அனைத்தையும் படிக்கும் அணுகலை அது வழங்குகிறது. உருவாக்கிய உடனே முழு விசை ஒரே ஒருமுறை காட்டப்படும் — கடவுச்சொல் மேலாளரிலோ ரகசியச் சேமிப்பகத்திலோ சேமியுங்கள். இழந்தால் அதைத் திரும்பப்பெற்று புதிய விசையை உருவாக்குங்கள்.

ஒவ்வொரு கோரிக்கையிலும் Bearer டோக்கனாக விசையை அனுப்ப வேண்டிய Authorization தலைப்பு:

# List projects in your workspace curl -H "Authorization: Bearer mp_live_..." \ https://www.mouseplayer.com/api/v1/projects

இல்லாத, தவறான வடிவிலான அல்லது திரும்பப்பெறப்பட்ட விசைகளுக்கு 401 பதில் கிடைக்கும்:

{ "error": "Invalid or missing API key. Use: Authorization: Bearer <key>" }

தேவைப்படும் திட்டம்

REST API இடம்பெறும் திட்டங்கள் Business மற்றும் Enterprise . திட்டம் பணியிடத்தின் உரிமையாளரிடமிருந்து எடுக்கப்படுகிறது; அழைக்கப்பட்ட குழு உறுப்பினர்களுக்கும் அதுவே பொருந்தும். சோதனை நடப்பது ஒவ்வொரு கோரிக்கையிலும்; விசை உருவாக்கும்போது மட்டும் அல்ல — பணியிடத்தின் திட்டம் குறைக்கப்பட்டால், தற்போதைய விசைகள் வேலை செய்வதை நிறுத்தி, 403என்பதை வழங்கும்.

விசை அனுமதிகள்

ஒவ்வொரு விசையின் முன்னொட்டிலும் அதன் அனுமதி உள்ளது. எனவே விசையைப் பார்த்தாலே அதன் செயல்பாட்டை அறியலாம் — .envஒன்றிலோ, சீட்டிலோ, முனையத்திலோ.

முன்னொட்டுபொருள்
mp_ro_படிப்பதற்கு மட்டும். திட்டங்கள், அமர்வுகள், நிகழ்வுகள், பிரிவுகளைப் படிக்கும். எதையும் மாற்ற முடியாது.
mp_rw_படித்தல் மற்றும் எழுதுதல். மேலுள்ள அனைத்தும்; கூடுதலாக identify முனையம் வழியாக வாடிக்கையாளர் ID-களை இணைத்தல்.
விசையை உருவாக்கும்போது அனுமதியைத் தேர்ந்தெடுங்கள்; இயல்புநிலை படிப்பதற்கு மட்டும். எழுதும் முனையத்தில் படிக்கும் விசையைப் பயன்படுத்தினால் 403 கிடைக்கும்; விசையின் அனுமதியையும் முனையத்திற்குத் தேவையானதையும் செய்தி குறிப்பிடும். பின்னர் அனுமதியை மாற்ற முடியாது — புதிய விசையை உருவாக்கி பழையதைத் திரும்பப்பெறுங்கள்.

3. கோரிக்கை வீத வரம்புகள்

ஒவ்வொரு API விசைக்கும் உள்ள வரம்பு நிமிடத்திற்கு 60 கோரிக்கைகள்; நகரும் காலச்சாளரத்தில் கண்காணிக்கப்படுகிறது. இதை மீறினால் காலச்சாளரம் விடுபடும்வரை கோரிக்கைகளுக்கு 429 பதில் கிடைக்கும்:

{ "error": "Rate limit exceeded. Max 60 requests per minute." }

அதிக வரம்பு தேவைப்படும் ஒன்றை உருவாக்குகிறீர்களா? தொடர்புகொள்ளுங்கள்: ஆதரவு ; உங்கள் பயன்பாட்டை எங்களுக்குத் தெரிவியுங்கள்.

4. முனையங்கள்

GET/api/v1/projects

உங்கள் பணியிடத்தின் ஒவ்வொரு திட்டத்தையும் (கண்காணிக்கப்படும் தளத்தையும்) பட்டியலிடும்.

{ "data": [ { "channelid": "955a45df5ee842cb", "domain": "yourdomain.com", "status": "active", "total_traffic_bytes": 27304765, "created_at": "2026-07-19 22:06:39", "last_used": "2026-08-05 01:12:55" } ] }

GET/api/v1/projects/{channelid}/sessions

ஒரு திட்டத்திற்காகப் பதிவான பார்வையாளர் அமர்வுகளைப் புதியவை முதலில் வருமாறு பட்டியலிடும். பக்கங்களாகப் பிரிக்கப்படும்.

வினவல் அளவுருவிளக்கம்
pageபக்க எண்; இயல்புநிலை 1.
per_pageபக்கத்திற்கான முடிவுகள்; இயல்புநிலை 25; அதிகபட்சம் 100.
sinceஇந்தத் தேதியிலோ அதன் பிறகோ தொடங்கிய அமர்வுகள் மட்டும் (YYYY-MM-DD).
untilஇந்தத் தேதியிலோ அதற்கு முன்போ தொடங்கிய அமர்வுகள் மட்டும்.
{ "data": [ { "session_id": "s_kfmist058_1785795295504", "visitor_id": "v_sv90jdpzo_1785795296042", "custom_user_id": null, "country": "DE", "device_type": "desktop", "is_bot": 0, "start_time": "2026-08-04 00:14:56", "end_time": "2026-08-04 00:16:41", "duration_seconds": 105 } ], "pagination": { "page": 1, "per_page": 25, "total": 142, "total_pages": 6 } }

GET/api/v1/sessions/{session_id}

ஓர் அமர்வின் மெட்டாடேட்டாவும் அதன் பக்கப் பார்வைகளும். முழுப் பதிவுத் தரவு வேண்டுமென்றே விலக்கப்பட்டுள்ளது — அதற்கு டாஷ்போர்டின் பிளேயரைப் பயன்படுத்துங்கள்.

{ "data": { "session_id": "s_kfmist058_1785795295504", "channelid": "955a45df5ee842cb", "visitor_id": "v_sv90jdpzo_1785795296042", "country": "DE", "asn_org": "Deutsche Telekom AG", "referrer": "https://duckduckgo.com/", "device_type": "desktop", "start_time": "2026-08-04 00:14:56", "end_time": "2026-08-04 00:16:41", "duration_seconds": 105, "pageviews": [ { "pageview_id": 1199, "url": "https://yourdomain.com/pricing", "page_title": "Pricing", "start_time": "2026-08-04 00:14:56", "end_time": "2026-08-04 00:16:41" } ] } }

GET/api/v1/sessions/{session_id}/events

அமர்வில் நடந்த தனிப்பயன் நிகழ்வுகள் (நீங்கள் mp('event', ...)மூலம் அனுப்பும் அதே நிகழ்வுகள்); அவற்றின் அளவுருக்களுடன்.

{ "data": [ { "event_id": 61, "pageview_id": 1199, "event_name": "add_to_cart", "created_at": "2026-08-04 00:14:59", "params": { "item_id": "SKU_98765", "price": 299.99 } } ] }

GET/api/v1/projects/{channelid}/segments

திட்டத்திற்காக வரையறுக்கப்பட்ட பார்வையாளர் பிரிவுகளைப் பட்டியலிடும்; திட்டத்திற்குரிய மற்றும் பணியிடம் முழுவதற்குமான பிரிவுகள் இரண்டும்.

{ "data": [ { "segment_id": 4, "name": "High Intent Visitors", "description": "Pageviews > 5", "badge_color": "cyan", "is_global": 0, "created_at": "2026-08-03 00:00:43" } ] }

5. உங்கள் பின்பக்கத்திலிருந்து வாடிக்கையாளர் ID-ஐ இணைத்தல்

அங்கு அமர்ந்திருப்பவர் யார் என்பது பெரும்பாலும் உலாவிக்குத் தெரியாது. B2B தயாரிப்பில் உள்நுழைந்த பிறகு அடையாளம் உறுதியாகும் — உங்கள் பின்பக்கத்தில். கடையில் ஆர்டர் உறுதிப்படுத்தலுடன் அது உறுதியாகும். அந்தத் தருணத்திற்காகவே இந்த முனையம்.

POST /api/v1/sessions/{session_id}/identify
Authorization: Bearer mp_live_xxxxxxxxxxxx
Content-Type: application/json

{"user_id": "customer-4711"}

// 200 OK
{"data": {"session_id": "s_a1b2c3", "user_id": "customer-4711",
          "changed": true, "previous": null, "webhook_queued": true}}

பின்னர் ID அமர்வுப் பட்டியலில் தோன்றும்; அங்கு தேடலாம்; மேலும் session_identified வெப்ஹுக் செயல்படும் — இப்படித்தான் அது உங்கள் CRM-ஐ அடைகிறது.

ஒரே ID உடன் இருமுறை அழைப்பது பாதுகாப்பானது. பதிலில் "changed": false கிடைக்கும்; வெப்ஹுக் அனுப்பப்படாது. மீண்டும் வந்த ஆர்டர் இரண்டாவது வாடிக்கையாளர் தொடர்பை உருவாக்காது.
நிலைஎப்போது
400தேவையான புலம் இல்லை, user_id 128 எழுத்துகளை மீறுகிறது அல்லது கட்டுப்பாட்டு எழுத்துகள் உள்ளன. குறைப்பதற்குப் பதிலாக நிராகரிக்கிறோம் — அமைதியாகக் குறைக்கப்பட்ட ID உங்கள் CRM-இல் எதனுடனும் பொருந்தாது; இருந்தாலும் வெற்றிபோல் தோன்றும்.
404அமர்வு இல்லை அல்லது உங்கள் பணியிடத்தைச் சேர்ந்தது அல்ல. இரண்டிற்கும் வேண்டுமென்றே ஒரே பதில்.
403பணியிடத் திட்டத்தில் API இல்லை.

6. வெப்ஹுக்குகள்: கையொப்பத்தைச் சரிபார்த்தல்

ஒவ்வொரு திட்டத்திற்கும் வெப்ஹுக்குகளை அமைக்கும் இடம் ஒருங்கிணைப்புகள்; கையொப்ப ரகசியமும் அங்கே கிடைக்கும். ஒவ்வொரு அனுப்பலிலும் இந்தத் தலைப்புகள் இருக்கும்:

தலைப்புபொருள்
X-MousePlayer-Eventநிகழ்வுப் பெயர்; எ.கா. session_identified
X-MousePlayer-TimestampUnix வினாடிகள் — கையொப்பமிடப்பட்ட உரையின் பகுதி
X-MousePlayer-Attemptமுதல் முயற்சியில் 1; மறுமுயற்சிகளில் அதிகரிக்கும்
X-MousePlayer-Signaturesha256=<hex>

கையொப்பம், பின்வருவதன் மீதான HMAC-SHA256: timestamp + "." + raw body; உங்கள் திட்டத்தின் கையொப்ப ரகசியம் விசையாகப் பயன்படும்.

// PHP
$erwartet = 'sha256=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);
if (!hash_equals($erwartet, $signature)) { http_response_code(401); exit; }

// Node
const expected = 'sha256=' + crypto.createHmac('sha256', secret)
                                     .update(timestamp + '.' + rawBody).digest('hex');
கையொப்பமிட வேண்டியது மூல உடல்தான்; JSON-ஐப் பகுப்பதற்கு முன். மீண்டும் வரிசையாக்கினால் விசை வரிசையும் இடைவெளிகளும் மாறும்; கையொப்பம் பொருந்தாது. சில நிமிடங்களுக்கு மேல் பழைய நேரமுத்திரை உள்ளவற்றையும் நிராகரியுங்கள் — நேரமுத்திரையின் நோக்கமே அதுதான்.

அனுப்பலும் மறுமுயற்சிகளும்

அனுப்பல் தோல்வியடைந்தால், மீண்டும் முயலும் இடைவெளிகள் 1 நிமிடம், 5 நிமிடம், 15 நிமிடம், 1 மணி, 6 மணி; பின்னர் முயற்சி கைவிடப்படும். 4xx பதில்களில் 408 மற்றும் 429 ஆகியவற்றைத் தவிர மற்றவை மீண்டும் முயலப்படாது — அவை "இப்படி வேண்டாம்" என்கின்றன; "இப்போது வேண்டாம்" என்பதல்ல. விரைவாகப் பதிலளிக்க வேண்டியது 2xx ; பின்னர் வேலையைச் செய்யுங்கள். அனுப்பல் 10 வினாடிகளில் காலாவதியாகும்.

கிடைக்கும் நிகழ்வுகள்

நிகழ்வுஎப்போது செயல்படும்
session_identifiedஉலாவி அல்லது API வழியாக அமர்விற்கு முதன்முறையாக வாடிக்கையாளர் ID கிடைக்கும்போது —
session_endedஅமர்வு முடியும் போது ஒருமுறை
goal_reachedஉங்கள் இலக்குகளில் ஒன்றைத் தனிப்பயன் நிகழ்வு நிறைவேற்றும்போது, அமர்வுக்கு ஒருமுறை. “event” வகை இலக்குகள் மட்டும் — URL, காலஅளவு, பக்கப் பார்வை மற்றும் ஃபனல் இலக்குகள் மதிப்பிடப்படுவதில்லை. இதில் உள்ளவை goal_id, goal_name, goal_value மற்றும் currency.
high_value_sessionஒரு நாளில் பார்வையாளர் இந்தத் திட்டத்தின் மதிப்பு வரம்பை முதன்முறையாகக் கடக்கும்போது. வரம்பு உங்கள் சொந்த மதிப்பெண் பரவலிலிருந்து பெறப்படுகிறது (கடந்த 90 நாட்களின் 90வது சதவீதப் புள்ளி); நிலையான எண் அல்ல. குறைந்தது 20 பார்வையாளர்களுக்கு மதிப்பெண் வழங்கும் வரை அது இருக்காது. இதில் உள்ளவை visitor_id, value_score, threshold மற்றும் அந்த நாளில் பார்ப்பதற்கு மிகுந்த பயனுள்ள அமர்வு.
funnel_dropoffஉங்கள் ஃபனல்களில் ஒன்றில் நுழைந்து அதை முடிக்காத அமர்வின் முடிவில். நின்ற படியைக் குறிப்பிடும் (dropped_at). விலகல் என்பது நிகழ்வு இல்லாதிருப்பது; எனவே அமர்வு முடிந்த பிறகே அதை அறிய முடியும். ஃபனலில் நுழையாத அமர்வுகள் விலகல்கள் அல்ல; இந்த நிகழ்வைத் தூண்டாது.
high_friction_sessionதடை மதிப்பெண் முதன்முறையாக வரம்பை அடையும்போது, அமர்வுக்கு ஒருமுறை (இயல்புநிலை 60; மொத்தம் 100). இதில் உள்ளவை friction_score, அதன் பின்னுள்ள சமிக்ஞைகள் (reasons) மற்றும் வரம்பைக் கடந்த சமிக்ஞை (trigger).
element_brokenபல நாட்களாகச் சோதிக்கப்பட்ட எந்தப் பக்கப் பார்வையிலும் கண்காணிக்கப்படும் உறுப்பு கிடைக்காதபோது ஒருமுறை — பொதுவாக மறுவெளியீட்டுக்குப் பிறகு. குறியீடு மீண்டும் பொருந்தி மறுபடியும் செயலிழந்தால் மட்டுமே இது மீண்டும் செயல்படும். இந்த நிகழ்வு எந்த அமர்வையும் சார்ந்ததல்ல: session_id மற்றும் session_url ஆகியவை null, link_url அதற்குப் பதிலாகக் குறியீட்டைத் திறக்கும்; subject_id குறியீட்டின் பெயரைக் குறிப்பிடும் — ஒவ்வொரு பதிப்பிற்கும் அதே பெயர்; எனவே மீண்டும் செயலிழக்கும் புதிய தேர்வி திறந்துள்ள அதே சம்பவத்தில் சேரும். இதில் உள்ளவை rule_id, rule_name, selector, page, checked_page_views, window_days மற்றும் last_matched. பார்வையாளர் தரவு இல்லை.
element_recoveredஇதற்கான மீட்பு அறிவிப்பு: element_broken: குறியீடு உண்மையில் மீண்டும் உறுப்பைக் கண்டறிந்ததும் — பக்கப் பார்வைகள் குறைவாக இருப்பது மட்டும் போதாது. முன்பு element_broken வெப்ஹுக் மூலம் அனுப்பப்பட்டிருந்தால் மட்டுமே அனுப்பப்படும். இதற்குத் தனி மாறுவிசை இல்லை: element_broken என்பதற்கான சந்தாவில் இதுவும் அடங்கும். அதே subject_idஎன்பதால் PagerDuty சம்பவத்தைத் தீர்த்ததாகவும் Opsgenie எச்சரிக்கையை மூடியதாகவும் குறிக்கும். கூடுதலாக இதில் உள்ளவை matched_page_views மற்றும் checked_page_views .
anomaly_detectedமுந்தைய 28 நாட்களிலிருந்து நேற்று தெளிவாக மாறுபட்டிருந்தால், நாளுக்கு ஒருமுறை: மிகவும் குறைந்த அல்லது அதிக அமர்வுகள், குறைந்த இலக்கு விகிதம், தடைகளோ JS பிழைகளோ உள்ள அதிக அமர்வுகள். அதே அளவீடும் திசையும் ஒரு வாரம் அமைதியாக இருக்கும்; இதை மாற்றலாம். இந்த நிகழ்வு எந்த அமர்வையும் சார்ந்ததல்ல: session_id மற்றும் session_url ஆகியவை null, link_url திட்டக் கண்ணோட்டத்தைத் திறக்கும்; subject_id அளவீடு, திசை, நாள் ஆகியவற்றைக் குறிப்பிடும். இதில் உள்ளவை metric (sessions, goal_rate, friction_rate, js_error_rate, lcp_p75, inp_p75, cls_p75), direction, day, value, expected, sessions, robust_z, z_score மற்றும் படிக்கக்கூடிய summary மற்றும் hint. பார்வையாளர் தரவு இல்லை. Web Vitals-க்கு, measurements என்பது இதை மாற்றும்: sessionsவரும்; மேலும் page (முழுத் தளத்திற்கும் காலியாக இருக்கும்) மற்றும் device (desktop அல்லது mobil) நிகழ்ந்த இடத்தைக் குறிப்பிடும்; link_url பின்னர் Web Vitals தாவலைத் திறக்கும்.
rage_clickஆவேசக் கிளிக் கண்டறியப்படும்போது
error_detectedமுன்பக்க விதிவிலக்கு ஏற்படும்போது
ceஉங்கள் சொந்த தனிப்பயன் நிகழ்வுகளுக்கான கூட்டுச் சந்தா. மேலுள்ள நிகழ்வுகள் இதில் அடங்காது — அவற்றுக்குத் தனித்தனி மாறுவிசைகள் உள்ளன.

7. பிழைகள் & நிலைக் குறியீடுகள்

நிலைபொருள்
200வெற்றி.
401API விசை இல்லை, தவறான வடிவில் உள்ளது அல்லது திரும்பப்பெறப்பட்டுள்ளது.
404கோரிய திட்டம் அல்லது அமர்வு இல்லை; அல்லது உங்கள் பணியிடத்தைச் சேர்ந்ததல்ல.
429கோரிக்கை வீத வரம்பு மீறப்பட்டது — இந்த விசையால் நிமிடத்திற்கு 60 கோரிக்கைகளுக்கு மேல் அனுப்புகிறீர்கள்.
403பணியிடத் திட்டத்தில் REST API இல்லை. செய்தி தேவைப்படும் திட்டத்தையும் தற்போதைய திட்டத்தையும் குறிப்பிடும்.

8. பாதுகாப்புக் குறிப்புகள்

  • படிக்கும் விசைகள் (mp_ro_) எதையும் மாற்ற முடியாது. எழுதும் விசைகள் (mp_rw_) வாடிக்கையாளர் ID-களை மட்டுமே இணைக்கலாம். எந்த விசையாலும் தரவை நீக்கவோ மூலப் பதிவுத் தரவை ஏற்றுமதி செய்யவோ முடியாது.
  • ஒவ்வொரு கோரிக்கையும் விசையின் சொந்தப் பணியிடத்திற்குத் தானாக வரம்பிடப்படும் — வேறு பணியிட ID-ஐ வழங்கி மற்றவரின் தரவைப் பார்க்க வழியில்லை.
  • எந்த நேரத்திலும் விசையைத் திரும்பப்பெறும் இடம் /api-keys; திரும்பப்பெறுதல் உடனடியாகச் செயல்படும்.
  • உங்கள் API விசையைக் கடவுச்சொல் போலக் கையாளுங்கள். தவறுதலாகப் பொது களஞ்சியத்தில் அதை கமிட் செய்தால், உடனடியாகத் திரும்பப்பெற்று புதிய விசையை உருவாக்குங்கள்.

வரம்புள்ள நிகழ்வுப் பக்கங்கள் (API v1, 14 அக்டோபர் 2026)

GET /api/v1/sessions/{session_id}/events இயல்பாக அதிகபட்சம் 100 நிகழ்வுகளை வழங்கும். per_page-ஐ 1 முதல் 100 வரையிலான முழு எண்ணாக அமைக்கவும். அடுத்த கோரிக்கையில் cursor-ஐ மாற்றாமல் அனுப்பி pagination.next_cursor-ஐப் பின்பற்றவும்; அதே அமர்வையும் பணியிடத்தையும் வைத்திருக்கவும். நிகழ்வுகள் created_at மற்றும் event_id வரிசையில் இருக்கும். கர்சர்கள் கையொப்பமிடப்பட்டு அந்த அமர்வுக்கும் பணியிடத்துக்கும் கட்டுப்படுத்தப்பட்டவை. மொத்த எண்ணிக்கையோ எண் வடிவப் பக்கமோ வழங்கப்படாது.

தற்போதைய data வரிசையும் params வரைபடமும் தொடர்ந்து கிடைக்கும். pagination.returned என்பது உண்மையில் வழங்கிய எண்ணிக்கை; pagination.has_more அடுத்த பக்கம் இருப்பதைக் குறிக்கும். முடிந்ததும் next_cursor null ஆகும். பதில் 524288 பைட்டுகளுக்குள் வரம்பிடப்படும்; எனவே பக்கத்தில் per_page-ஐவிடக் குறைவான நிகழ்வுகள் இருக்கலாம். ஒரு நிகழ்விற்கு அதிகபட்சம் 128 அளவுரு வரிசைகள் வழங்கப்படும்; கூடுதலாக இருந்தால் params_truncated true ஆகும். தனித்த சர அளவுருக்களுக்கு தரவுத்தளத்தின் 255 எழுத்து வரம்பு தொடரும். குறைக்கப்பட்ட அளவுருக்கள் இந்த முனையத்தில் கிடைக்காது. per_page-ஐக் குறைப்பதால் அளவுரு வரம்பு உயராது.

தவறான பக்க அளவுகள், மாற்றப்பட்ட கர்சர்கள், வேறு அமர்வு/பணியிடத்திற்கான கர்சர்கள் ஆகியவற்றிற்கு 400 கிடைக்கும். தனிப்பட்ட நிகழ்வுத் தரவு மிகப் பெரியதாக இருந்தால் 413 கிடைக்கும். தற்போதைய அணுகல் சோதனைகள் பொருத்தமாக 401, 403, 404 அல்லது 409-ஐத் தொடர்ந்து வழங்கும்.

வரம்பு API விசைக்கு நிமிடத்திற்கு 60 அங்கீகரிக்கப்பட்ட கோரிக்கைகளாகவே இருக்கும். தீர்ந்தால் 429 கிடைக்கும்; அதில் Retry-After: 60 இருக்கும். Redis அல்லது வரம்பிடுவான் கிடைக்காவிட்டால் 503 கிடைக்கும்; அதில் Retry-After: 5 இருக்கும். வரம்பில்லாமல் கோரிக்கைகள் அனுமதிக்கப்படுவதில்லை. Retry-After-ஐ மதித்து, சீரற்ற காத்திருப்பு இடைவெளியைச் சேர்க்கவும்; குறுகிய சுழற்சியில் மீண்டும் முயல வேண்டாம். நிகழ்வுத் தரவுத்தளத் தோல்விகளுக்கும் 503 கிடைக்கும். கர்சர்கள் நிலைப்படத்தை உறையவைக்காது: பழைய நேரமுத்திரைகளுடன் ஒரே நேரத்தில் சேர்க்கப்படும் பதிவுகளுக்கு புதிய முழுச் சோதனை தேவைப்படலாம்.

GET /api/v1/sessions/s_example/events?per_page=25
GET /api/v1/sessions/s_example/events?per_page=25&cursor=SIGNED_CURSOR

/api/v1/native என்பது native SDK முன்னோட்டத்திற்கான Dev-இல் மட்டும் உள்ள பின்பக்கக் கட்டுப்பாட்டு வழி. உற்பத்திச் சூழலில் அது முடக்கப்பட்டே இருக்கும். பின்பக்க Bearer விசைகளுக்கு list/replay-க்கு படிக்கும் அனுமதியும் register/grant/delete/disable-க்கு எழுதும் அனுமதியும் தேவை. கூடுதல் native-preview கிடைப்புச் சோதனைகளும் பொருந்தும். நிரந்தரப் பணியிட API விசைகளை மொபைல் செயலியில் ஒருபோதும் உட்பொதிக்க வேண்டாம்.