فهرست رویدادها

پارامترها

Lingara-Versionheaderstringاختیاری

نسخهٔ API‌ای که این درخواست با آن جواب داده می‌شود. بدون آن، توکن دسترسی نسخه‌ای را می‌گیرد که کلاینت آن به آن وصل است، و درخواستی بدون توکن نسخهٔ فعلی را می‌گیرد. به نسخه‌ای که هنوز در حال انکشاف است تنها با نام‌بردن آن در اینجا می‌توان رسید. نسخهٔ ناشناخته با 400 و کد api_version_unknown جواب داده می‌شود. GET /v1/versions نسخه‌ها را فهرست می‌کند.

cursorquerystringاختیاری

از کجا ادامه دهید: next_cursor یک صفحهٔ قبلی، یا id: یک رویداد جریان. نشانگری کهنه‌تر از ۳۰ روز با 410 و کد cursor_expired پاسخ می‌گیرد.

startquerystringاختیاری

بدون نشانگر از کجا آغاز کنید: latest برای رویدادها از همین حالا به بعد، یا oldest برای هر رویدادی که هنوز نگه داشته شده است.

typesqueryarray of stringاختیاری

فقط این نوع رویدادها، جداشده با کامه. بدون آن، هر نوعی که ساحه‌های توکن شما خوانده می‌توانند.

limitqueryintegerاختیاری

بیشترین تعداد رویدادی که یک صفحه برمی‌گرداند، از ۱ تا ۱۰۰.

پاسخ‌ها

200 یک صفحه از رویدادها و نشانگری که از آن ادامه می‌دهید

itemsarray of EventEnvelopeضروری

idstringضروری

typestringضروری

created_atstringضروری

api_versionstringضروری

subjectstringضروری

dataobjectضروری

next_cursorstringضروری

has_morebooleanضروری

خطاها

410application/json

api_version_discontinued: نسخهٔ API این درخواست متوقف شده است. cursor_expired: نشانگر کهنه‌تر از ۳۰ روز است؛ بدون آن دوباره آغاز کنید.

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"

کتابخانه را ترجیح می‌دهید؟ بخش کتابخانه‌ها را ببینید.