ئاممىۋى API ۋە API ئاچقۇچلىرى

1. ئومۇمىي كۆرۈنۈش

MousePlayer API سى خىزمەت بوشلۇقىڭىزدىن ئۆز باشقۇرۇش تاختىلىرىڭىز، سانلىق مەلۇمات ئامبىرىڭىز ياكى ئىچكى قوراللىرىڭىزغا سانلىق مەلۇمات ئېلىش ئىمكانىنى بېرىدۇ. سېسىيەگە خېرىدار كىملىكى باغلاشتىن (identify، يېزىش دائىرىلىك ئاچقۇچ كېرەك، ئاچقۇچ دائىرىسىگە قاراڭ) باشقا، ئۇ پەقەت ئوقۇشقا خاس: API ئارقىلىق سانلىق مەلۇماتنى ئۆزگەرتىش ياكى ئۆچۈرۈش مۇمكىن ئەمەس.

ئاساسىي URL: https://www.mouseplayer.com/api/v1/
بارلىق جاۋابلار JSON.
ھەر تەلەپ API ئاچقۇچى بىلەن دەلىللىنىدۇ ۋە ئاپتوماتىك ھالدا شۇ ئاچقۇچ تەۋە خىزمەت بوشلۇقى بىلەن چەكلىنىدۇ — بىر خىزمەت بوشلۇقىنىڭ ئاچقۇچى باشقىسىنىڭ سانلىق مەلۇماتىنى ھەتتا تاسادىپىي ھالدىمۇ كۆرەلمەيدۇ.
تولۇق سېسىيە خاتىرىسى (چاشقىنەك ھەرىكەتلىرى، DOM سۈرەتلىرى) API ئارقىلىق ئېچىلمايدۇ . سېسىيە مېتا سانلىق مەلۇماتى، بەت كۆرۈنۈشلىرى، خاس ھادىسىلەر ۋە بۆلەكلەرنى ئالىسىز — خام خاتىرە يۈكمىسىنى يۆتكىمەي دوكلات ۋە باشقۇرۇش تاختىسى قۇرۇشقا يېتەرلىك.

2. كىملىك دەلىللەش

ھېسابات تىزىملىكىڭىزدىكى API ئاچقۇچلىرى ئاستىدا ئاچقۇچلىرىڭىزنى قۇرۇپ باشقۇرۇڭ (/api-keys). پەقەت خىزمەت بوشلۇقى ئىگىلىرى ۋە باشقۇرغۇچىلار ئاچقۇچ قۇرالايدۇ ياكى بىكار قىلالايدۇ.

ئاچقۇچىڭىزنى مەخپىي تۇتۇڭ. ئۇ خىزمەت بوشلۇقىڭىزدىكى ھەممىنى ئوقۇش ھوقۇقى بېرىدۇ. تولۇق ئاچقۇچ دەل بىر قېتىم، قۇرغان ھامان كۆرسىتىلىدۇ — ئۇنى پارول باشقۇرغۇچ ياكى مەخپىيەت ئامبىرىغا ساقلاڭ. يوقىتىپ قويسىڭىز، بىكار قىلىپ يېڭىسىنى قۇرۇڭ.

ئاچقۇچنى ھەر تەلەپنىڭ Authorization ماۋزۇسىدا Bearer token سۈپىتىدە ئەۋەتىڭ:

# 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 ئاخىرقى نۇقتىسى ئارقىلىق خېرىدار كىملىكى باغلاش.

ئاچقۇچ قۇرغاندا دائىرىنى تاللاڭ؛ سۈكۈتتىكىسى پەقەت ئوقۇش. ئوقۇشقىلا خاس ئاچقۇچنى يېزىش ئاخىرقى نۇقتىسىدا ئىشلەتسىڭىز 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. ئارقا تەرىپىڭىزدىن خېرىدار كىملىكى باغلاش

توركۆرگۈچ كۆپىنچە ئالدىدا كىمنىڭ ئولتۇرغانلىقىنى بىلمەيدۇ. 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}}

كىملىك ئاندىن سېسىيە تىزىملىكىدە كۆرۈنىدۇ، ئۇ يەردە ئىزدەشكە بولىدۇ ۋە session_identified webhook ى قوزغىلىدۇ — شۇ ئارقىلىق CRM غا يېتىدۇ.

ئوخشاش كىملىك بىلەن ئىككى قېتىم چاقىرىش بىخەتەر. جاۋاب "changed": false بىلەن قايتىدۇ، webhook ئەۋەتىلمەيدۇ. تەكرار زاكاز ئىككىنچى يوشۇرۇن خېرىدار قۇرمايدۇ.

ھالەت	قاچان
`400`	بۆلەك كەم، `user_id` 128 ھەرپتىن ئاشقان ياكى كونترول ھەرپلىرى بار. قىسقارتماي رەت قىلىمىز — جىمجىت قىسقارتىلغان كىملىك CRM دا ھېچنېمىگە ماس كەلمەيدۇ، شۇنداقتىمۇ مۇۋەپپەقىيەتتەك كۆرۈنىدۇ.
`404`	سېسىيە مەۋجۇت ئەمەس ياكى خىزمەت بوشلۇقىڭىزغا تەۋە ئەمەس. ھەر ئىككىسىگە قەستەن ئوخشاش جاۋاب.
`403`	خىزمەت بوشلۇقى پىلانى API نى ئۆز ئىچىگە ئالمايدۇ.

6. Webhook لار: ئىمزانى دەلىللەش

Webhook لار ھەر تۈرنىڭ بىرلەشتۈرۈشلەر ئاستىدا تەڭشىلىدۇ، ئىمزا مەخپىي ئاچقۇچىنىمۇ شۇ يەردىن تاپىسىز. ھەر يەتكۈزۈشتە تۆۋەندىكى ماۋزۇلار بار:

ماۋزۇ	مەنىسى
`X-MousePlayer-Event`	ھادىسە نامى، مەسىلەن `session_identified`
`X-MousePlayer-Timestamp`	Unix سېكۇنتى — ئىمزالانغان تېكىستنىڭ بىر قىسمى
`X-MousePlayer-Attempt`	بىرىنچى سىناقتا 1، قايتا سىناشتا يۇقىرىراق
`X-MousePlayer-Signature`	`sha256=<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 دىن
`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`	ھەر سېسىيەدە بىر قېتىم، توسالغۇ نومۇرى تۇنجى قېتىم چەككە يەتكەندە (سۈكۈتتىكىسى 100 دىن 60). تۆۋەندىكى بار: `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` webhook بىلەن چىققان بولسىلا ئەۋەتىلىدۇ، ئۆزىنىڭ ئايرىم ئالماشتۇرغۇچى يوق: `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`	مۇۋەپپەقىيەت.
`401`	API ئاچقۇچى كەم، شەكلى خاتا ياكى بىكار قىلىنغان.
`404`	سورالغان تۈر ياكى سېسىيە مەۋجۇت ئەمەس، ياكى خىزمەت بوشلۇقىڭىزغا تەۋە ئەمەس.
`429`	چاستوتا چېكى ئېشىپ كەتتى — بۇ ئاچقۇچ بىلەن مىنۇتىغا 60 تىن ئارتۇق تەلەپ ئەۋەتىۋاتىسىز.
`403`	خىزمەت بوشلۇقى پىلانى REST API نى ئۆز ئىچىگە ئالمايدۇ. ئۇچۇر كېرەكلىك پىلان بىلەن نۆۋەتتىكى پىلاننى ئاتايدۇ.

8. بىخەتەرلىك ئەسكەرتىشلىرى

ئوقۇشقىلا خاس ئاچقۇچلار (mp_ro_) ھېچنېمىنى ئۆزگەرتەلمەيدۇ. يېزىش ئاچقۇچلىرى (mp_rw_) پەقەت خېرىدار كىملىكى باغلىيالايدۇ؛ ھېچقانداق ئاچقۇچ سانلىق مەلۇمات ئۆچۈرەلمەيدۇ ياكى خام خاتىرە سانلىق مەلۇماتىنى چىقىرالمايدۇ.
ھەر تەلەپ ئاپتوماتىك ھالدا ئاچقۇچنىڭ ئۆز خىزمەت بوشلۇقى بىلەن چەكلىنىدۇ — باشقا خىزمەت بوشلۇقى كىملىكىنى يوللاپ باشقىلارنىڭ سانلىق مەلۇماتىنى كۆرۈش يولى يوق.
ئاچقۇچنى خالىغان ۋاقىتتا /api-keys دىن بىكار قىلىڭ؛ بىكار قىلىش دەرھال كۈچكە ئىگە.
API ئاچقۇچىڭىزنى پارولدەك تۇتۇڭ. تاسادىپىي ئاممىۋى كود ئامبىرىغا commit قىلىپ قويسىڭىز، دەرھال بىكار قىلىپ يېڭىسىنى قۇرۇڭ.

چەكلىك ھادىسە بەتلىرى (API v1، 14 ئۆكتەبىر 2026)

GET /api/v1/sessions/{session_id}/events سۈكۈتتىكى ھالەتتە ئەڭ كۆپ 100 ھادىسە قايتۇرىدۇ. per_page نى 1 دىن 100 گىچە پۈتۈن سانغا تەڭشەڭ. pagination.next_cursor غا ئەگىشىش ئۈچۈن كېيىنكى تەلەپتە cursor نى ئۆزگەرتمەي ئەۋەتىڭ؛ ئوخشاش سېسىيە ۋە خىزمەت بوشلۇقىنى ساقلاڭ. ھادىسىلەر created_at ۋە event_id بويىچە رەتلىنىدۇ. cursor لار ئىمزالانغان ۋە شۇ سېسىيە بىلەن خىزمەت بوشلۇقىغا باغلانغان. ئومۇمىي سان ياكى سانلىق بەت قايتۇرۇلمايدۇ.

مەۋجۇت data ماسسىپى ۋە params خەرىتىسى قالىدۇ. pagination.returned ئەمەلىي قايتۇرۇلغان سان؛ pagination.has_more يەنە بەت بارلىقىنى كۆرسىتىدۇ. تامام بولغاندا next_cursor بولسا null. جاۋاب 524288 بايت بىلەن چەكلىنىدۇ، شۇڭا بەتتە per_page دىن ئاز ھادىسە بولۇشى مۇمكىن. ھەر ھادىسە ئۈچۈن ئەڭ كۆپ 128 پارامېتىر قۇرى قايتۇرىدۇ؛ ئارتۇق بولسا params_truncated بولسا true. يەككە ھەرپ تىزمىسى پارامېتىرلىرى سانداننىڭ 255 ھەرپ چېكىنى ساقلايدۇ. قىسقارتىلغان پارامېتىرلارنى بۇ ئاخىرقى نۇقتىدىن ئالغىلى بولمايدۇ. per_page نى ئازايتىش پارامېتىر چېكىنى ئاشۇرمايدۇ.

ئىناۋەتسىز بەت چوڭلۇقى، ئۆزگەرتىلگەن cursor ۋە باشقا سېسىيە/خىزمەت بوشلۇقىنىڭ cursor ى 400 قايتۇرىدۇ. ھەددىدىن چوڭ يەككە ھادىسە سانلىق مەلۇماتى 413 قايتۇرىدۇ. مەۋجۇت زىيارەت تەكشۈرۈشلىرى ماس ھالدا 401، 403، 404 ياكى 409 نى يەنىلا قايتۇرىدۇ.

چەك ھەر API ئاچقۇچىغا مىنۇتىغا 60 دەلىللەنگەن تەلەپ پېتى قالىدۇ. تۈگىگەندە Retry-After: 60 بىلەن 429 قايتۇرىدۇ. Redis ياكى چەكلىگۈچ ئىشلىمىسە، تەلەپلەر Retry-After: 5 بىلەن 503 قايتۇرىدۇ؛ چەكسىز ھەرگىز قوبۇل قىلىنمايدۇ. Retry-After غا ئەمەل قىلىپ تاسادىپىي ساقلاش قوشۇڭ؛ زىچ دەۋرىيلىكتە قايتا سىنىماڭ. ھادىسە ساندانى مەغلۇبىيىتىمۇ 503 قايتۇرىدۇ. cursor لار مۇقىم سۈرەتنى توڭلاتمايدۇ: كونا ۋاقىت تامغىسى بىلەن تەڭ ۋاقىتتا كىرگۈزۈلگەن قۇرلار يېڭى سايىلاش تەلەپ قىلىشى مۇمكىن.

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 ئالدىن كۆرۈش ئىشلىتىشچانلىق تەكشۈرۈشلىرى قوللىنىدۇ. كۆچمە ئەپكە مەڭگۈلۈك خىزمەت بوشلۇقى API ئاچقۇچلىرىنى ھەرگىز قىستۇرماڭ.

قانداق ياردەم بېرەلەيمىز؟