ህዝባዊ API & መፍትሒታት API

1. ሓፈሻዊ ትርኢት

API MousePlayer ሓበሬታ ካብ ናይ ስራሕ ቦታኹም ናብ ናትኩም ሰሌዳታት ቁጽጽር፣ መኽዘን ሓበሬታ ወይ ውሽጣዊ መሳርሒታት ክትወስዱ የኽእለኩም። 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_`	ንንባብን ምጽሓፍን። ኩሉ እቲ ኣብ ላዕሊ፣ ብተወሳኺ IDታት ዓሚል ብመወዳእታ ነጥቢ 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. 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 webhook ድማ ይጅምር — ናብ CRMኩም ዝበጽሓሉ መንገዲ እዚ እዩ።

ብተመሳሳሊ ID ክልተ ግዜ ምጽዋዕ ውሑስ እዩ። እቲ መልሲ ምስዚ ይምለስ፦ "changed": false ከምኡውን webhook ኣይለኣኽን። ዝተደግመ ትእዛዝ ካልኣይ ናይ ዓሚል ዕድል ኣይፈጥርን።

ኩነታት	መዓስ
`400`	ዝጎደለ ዓውዲ፣ `user_id` ካብ 128 ፊደላት ንላዕሊ፣ ወይ ናይ ቁጽጽር ፊደላት ኣብ ውሽጡ። ኣብ ክንዲ ምቑራጽ ንነጽጎ — ብስቕታ ዝሓጸረ ID ኣብ CRMኩም ምስ ዋላ ሓንቲ ኣይሰማማዕን፣ ግን ከም ዓወት ይመስል።
`404`	እቲ ክፍለ ግዜ የለን ወይ ናይ ናይ ስራሕ ቦታኹም ኣይኮነን። ንክልቲኦም ብዕላማ ተመሳሳሊ መልሲ።
`403`	መደብ ናይ ስራሕ ቦታ API ኣየካትትን።

6. Webhooks፦ ክታም ምርግጋጽ

Webhooks ንነፍሲ ወከፍ ፕሮጀክት ኣብዚ ይቕጥዑ፦ ምውህሃዳት፣ ኣብኡ ድማ ምስጢር ክታም ትረኽቡ። ነፍሲ ወከፍ ምብጻሕ እዞም ርእስታት ይስከም፦

ርእሲ	ትርጉም
`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`	ክፍለ ግዜ ንመጀመርታ ግዜ ID ዓሚል ክረክብ ከሎ — ካብ መርበብ መርኣዪ ወይ API
`session_ended`	ሓንሳብ፣ ክፍለ ግዜ ክዕጾ ከሎ
`goal_reached`	ኣብ ክፍለ ግዜ ሓንሳብ፣ ብሕታዊ ፍጻመ ካብ ዕላማታትኩም ሓደ ከማልእ ከሎ። ዓይነቶም «ፍጻመ» ዝኾነ ዕላማታት ጥራይ — ናይ 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` ብ 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_) 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 መፍትሒታት ኣብ መተግበሪ ሞባይል ፈጺምኩም ኣይተእትዉ።

ብኸመይ ክንሕግዘኩም ንኽእል፧