ৰাজহুৱা API & API কী

প্ৰগ্ৰেমৰ জৰিয়তে আপোনাৰ কৰ্মক্ষেত্ৰত প্ৰৱেশ — প্ৰকল্প, ছেছন, নিজা ইভেণ্ট আৰু ছেগমেণ্ট পঢ়ক আৰু ছেছনৰ সৈতে গ্ৰাহক ID সংযুক্ত কৰক — কৰ্মক্ষেত্ৰৰ পৰিসৰৰ API কীৰে সুৰক্ষিত।

1. সংক্ষিপ্ত বিৱৰণ

MousePlayer API এ আপোনাৰ কৰ্মক্ষেত্ৰৰ পৰা নিজা ডেশ্বব’ৰ্ড, ডেটা ৱেৰহাউছ বা ভিতৰুৱা সঁজুলিলৈ তথ্য উলিয়াবলৈ দিয়ে। ছেছনত গ্ৰাহক ID সংযুক্ত কৰাৰ বাহিৰে (identify, লিখাৰ পৰিসৰৰ কী লাগে, কীৰ পৰিসৰ চাওক) ই কেৱল পঢ়াৰ বাবে: API ৰ জৰিয়তে কোনো তথ্য সলনি বা মচিব নোৱাৰি।

মূল URL: https://www.mouseplayer.com/api/v1/
সকলো উত্তৰ JSON।
প্ৰতিটো অনুৰোধ API কীৰে প্ৰমাণীকৰণ কৰা হয় আৰু কী যিটো কৰ্মক্ষেত্ৰৰ, স্বয়ংক্ৰিয়ভাৱে তাতেই সীমিত থাকে — এটা কৰ্মক্ষেত্ৰৰ কীয়ে আনটোৰ তথ্য কেতিয়াও চাব নোৱাৰে, ভুলতেও নহয়।
ছেছন পুনৰ চলোৱাৰ সম্পূৰ্ণ ৰেকৰ্ডিং (মাউছৰ চলাচল, DOM স্নেপশ্বট) API ৰ জৰিয়তে উপলব্ধ নহয় । আপুনি ছেছনৰ মেটাডেটা, পৃষ্ঠা দৰ্শন, নিজা ইভেণ্ট আৰু ছেগমেণ্ট পায় — কেঁচা পুনৰ চলোৱাৰ তথ্য ইফালে সিফালে নপঠোৱাকৈ প্ৰতিবেদন আৰু ডেশ্বব’ৰ্ড তৈয়াৰ কৰিবলৈ যথেষ্ট।

2. প্ৰমাণীকৰণ

আপোনাৰ একাউণ্ট মেনুৰ API কী অংশত কী সৃষ্টি আৰু পৰিচালনা কৰক (/api-keys)। কেৱল কৰ্মক্ষেত্ৰৰ মালিক আৰু প্ৰশাসকেহে কী সৃষ্টি বা বাতিল কৰিব পাৰে।

আপোনাৰ কী গোপনে ৰাখক। ই আপোনাৰ কৰ্মক্ষেত্ৰৰ সকলো তথ্য পঢ়াৰ অধিকাৰ দিয়ে। সৃষ্টি কৰাৰ ঠিক পিছত সম্পূৰ্ণ কী এবাৰহে দেখুওৱা হয় — পাছৱৰ্ড মেনেজাৰ বা গোপন তথ্যৰ ভঁৰালত ৰাখক। হেৰুৱালে বাতিল কৰি নতুন এটা সৃষ্টি কৰক।

প্ৰতিটো অনুৰোধৰ Authorization হেডাৰত Bearer টোকেন হিচাপে কী পঠাওক:

# 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. ৱেবহুক: স্বাক্ষৰ পৰীক্ষা কৰা

প্ৰতিটো প্ৰকল্পৰ ৱেবহুক বিন্যাস কৰা হয় সংযোগ ৰ অধীনত, য’ত স্বাক্ষৰৰ secret ও পাব। প্ৰতিটো ডেলিভাৰীত এই হেডাৰ থাকে:

হেডাৰ	অৰ্থ
`X-MousePlayer-Event`	ইভেণ্টৰ নাম, যেনে `session_identified`
`X-MousePlayer-Timestamp`	Unix ছেকেণ্ড — স্বাক্ষৰ কৰা পাঠৰ অংশ
`X-MousePlayer-Attempt`	প্ৰথম চেষ্টাত 1, পুনৰ চেষ্টাত বেছি
`X-MousePlayer-Signature`	`sha256=<hex>`

স্বাক্ষৰ হৈছে ইয়াৰ ওপৰত HMAC-SHA256: timestamp + "." + raw body, আপোনাৰ প্ৰকল্পৰ স্বাক্ষৰৰ secret কীৰে।

// 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`	ছেছনে প্ৰথমবাৰ গ্ৰাহক ID পালে — ব্ৰাউজাৰ বা 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`	প্ৰতি ছেছনত এবাৰ, বাধাৰ স্ক’ৰে প্ৰথমবাৰ সীমা পালে (অবিকল্পিত 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`	সফল।
`401`	নথকা, ভুল গঠনৰ বা বাতিল কৰা API কী।
`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 কী ম’বাইল এপত কেতিয়াও সংযোজন নকৰিব।

আমি কেনেকৈ সহায় কৰিব পাৰোঁ?