لیستی ڕووداوەکان

پارامەترەکان

Lingara-Versionheaderstringئارەزوومەندانە

ئەو وەشانەی API کە ئەم داواکارییەی پێ وەڵام دەدرێتەوە. بەبێ ئەمە، تۆکنی دەستگەیشتن ئەو وەشانە وەردەگرێت کە کڕیارەکەی پێیەوە بەستراوە، و داواکارییەکی بێ تۆکن وەشانی ئێستا وەردەگرێت. وەشانێک کە هێشتا لە گەشەپێداندایە تەنها بە ناوهێنانی لێرە دەگەیەندرێت. وەشانێکی نەناسراو بە 400 لەگەڵ کۆدی api_version_unknown وەڵام دەدرێتەوە. GET /v1/versions وەشانەکان لیست دەکات.

cursorquerystringئارەزوومەندانە

لە کوێوە بەردەوام بیت: next_cursorی پەڕەیەکی پێشوو، یان id:ی ڕووداوێکی ستریم. نیشاندەرێکی کۆنتر لە 30 ڕۆژ بە 410 و کۆدی cursor_expired وەڵام دەدرێتەوە.

startquerystringئارەزوومەندانە

لە کوێوە دەست پێ بکەیت بەبێ نیشاندەر: latest بۆ ڕووداوەکان لە ئێستاوە، یان oldest بۆ هەموو ڕووداوێک کە هێشتا پارێزراوە.

typesqueryarray of stringئارەزوومەندانە

تەنها ئەم جۆرە ڕووداوانە، بە کۆما جیاکراوە. بەبێ ئەو، هەموو جۆرێک کە مەوداکانی تۆکنەکەت دەتوانن بیخوێننەوە.

limitqueryintegerئارەزوومەندانە

زۆرترین ژمارەی ڕووداو کە یەک پەڕە دەیگەڕێنێتەوە، لە 1 تا 100.

وەڵامەکان

200 پەڕەیەک لە ڕووداوەکان و ئەو نیشاندەرەی لێیەوە بەردەوام دەبیت

itemsarray of EventEnvelopeپێویست

idstringپێویست

typestringپێویست

created_atstringپێویست

api_versionstringپێویست

subjectstringپێویست

dataobjectپێویست

next_cursorstringپێویست

has_morebooleanپێویست

هەڵەکان

410application/json

api_version_discontinued: وەشانی API ی ئەم داواکارییە ڕاگیراوە. cursor_expired: نیشاندەرەکە کۆنترە لە 30 ڕۆژ؛ بەبێ نیشاندەر دووبارە دەست پێ بکەرەوە.

4XXapplication/json

داواکارییەکە ڕەتکرایەوە. code هۆکارەکەی دەڵێت، و error بە وشە ڕوونی دەکاتەوە.

503application/json · text/plain

خزمەتگوزارییەکە بە شێوەیەکی کاتی بەردەست نییە؛ دوای ئەو ژمارە چرکەیەی کە Retry-After دیاری دەکات دووبارە هەوڵ بدەرەوە. لە کاتی چاککردنەوەدا، ناوەڕۆکی وەڵامەکە دەقی سادەیە نەک پێچراوەی هەڵە.

5XXapplication/json

داواکارییەکە ڕەتکرایەوە. code هۆکارەکەی دەڵێت، و error بە وشە ڕوونی دەکاتەوە.

codestringپێویست

هۆکاری ڕەتکردنەوەی داواکارییەکە، وەک کۆدێکی جێگیر بۆ لقبوونەوە لەسەری: بۆ نموونە insufficient_scope (403)، rate_limited (429) و، بۆ کلاینتێکی پێوانەکراو، spend_cap_reached (402) و metered_billing_inactive (402).

errorstringپێویست

نموونە

curl "https://api.getlingara.com/v1/events" \
  -H "Authorization: Bearer $LINGARA_TOKEN"

کتێبخانەیەکت پێ باشترە؟ بەشی کتێبخانەکان ببینە.