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

پارامترها

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"

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