محصولات داده

بانک‌ها، اتحادیه‌ها، نهادهای عمومی و شرکت‌های بزرگ می‌توانند مجموعه‌داده‌های تجمیعی Birlesa را به‌صورت انبوه و طبق قرارداد دریافت کنند. هر محصول از داده‌هایی ساخته می‌شود که پلتفرم همین حالا طبق قواعد خودش منتشر یا تجمیع می‌کند. هیچ چیزی جزئی‌تر یا شخصی‌تر از آنچه این قواعد اجازه می‌دهند تحویل داده نمی‌شود.

GET /v1/data/products این محصولات را با فیلدهای هر رکورد فهرست می‌کند. درون /v1 فیلدها فقط اضافه می‌شوند و هرگز تغییر نمی‌کنند یا حذف نمی‌شوند.

دسترسی

1. قراردادی امضا می‌شود. Birlesa آن را به‌عنوان یک مجوز دسترسی برای سازمان شما و یک محصول ثبت می‌کند. یکی دیگر از مدیران Birlesa آن را تأیید می‌کند؛ فقط پس از آن دسترسی باز می‌شود.
2. مالکان و مدیران سازمان شما مجوزهای دسترسی آن را می‌بینند: GET /v1/orgs/{org_id}/data-grants.
3. یک کلید API (یا کلاینت OAuth) با دسترسی data:read بسازید.
4. محصول را بخوانید:

GET /v1/data/products/price-index/records?since=2026-01 HTTP/1.1
Host: api.birlesa.com
Authorization: Bearer brl_api_...

پاسخ در قالب JSON lines است (application/x-ndjson)، از قدیمی‌ترین به جدیدترین. وقتی رکوردهای بیشتری باشد، سرآیند Birlesa-Next-Cursor نشانگر صفحهٔ بعد را دارد (&cursor=...). فیدها ۶ درخواست در دقیقه به ازای هر کلید اجازه می‌دهند؛ محصولات ماهانه را پس از انتشار یک بار بگیرید (روزهای ۵ و ۶ هر ماه) و محصول روزانه را روزی یک بار.

بازبینی دسترسی

هر مجوز دسترسی دست‌کم هر ۹۰ روز یک بار بازبینی می‌شود: آیا قرارداد هنوز معتبر است، آیا داده‌ها طبق توافق استفاده می‌شوند، آیا کلیدها در دست افراد درستی است؟ مجوزی که بازبینی‌اش عقب افتاده باشد، تا انجام بازبینی خودبه‌خود از کار می‌افتد؛ در این مدت درخواست‌ها پاسخ 403 با کد no_live_grant می‌گیرند. هر بار خواندن به نام همان قرارداد ثبت می‌شود.

خطاها