منتجات البيانات

يمكن للبنوك والاتحادات والجهات العامة والمؤسسات الكبيرة الحصول على مجموعات بيانات Birlesa المجمّعة دفعةً واحدة، بموجب عقد. وكل منتج مبني من بيانات تنشرها المنصة أو تجمّعها أصلًا وفق قواعدها الخاصة. ولا يُسلَّم شيء أدق أو أكثر خصوصية مما تسمح به تلك القواعد.

المنتج	السجلات	سجلات جديدة
`price-index`	الأسعار الشهرية لكل بند من بنود النظام المنسق (HS) ولكل وحدة أساس وعملة: الوسيط، والأرباع، ونطاق لعدد الأسعار، والتغير عن الشهر السابق (المنهجية)	شهريًا
`demand-forecasts`	لكل بند من بنود النظام المنسق ولكل وجهة: أعداد الطلب الشهرية وتوقعات لثلاثة أشهر مختبَرة على بيانات سابقة مع نطاقات 80% (المنهجية)	شهريًا
`b2b-index`	مؤشر B2B الشهري: تأسيس الشركات، وزيادات رأس المال، والتصفيات، والإغلاقات، والصلح الواقي من الإفلاس (konkordato)، والمناقصات والمطابقات، على المستوى الوطني ولكل ولاية ولكل قسم من أقسام NACE	شهريًا
`new-companies`	الشركات ذات الأشكال القانونية المؤسسية التي تأسست في آخر 90 يومًا، من إشعارات السجل الرسمية	يوميًا

يسردها GET /v1/data/products مع حقول كل سجل. ولا تُضاف الحقول إلا إضافةً، ولا تُغيَّر ولا تُحذف أبدًا، ضمن /v1.

الوصول

يُوقَّع عقد. فتسجله Birlesa إذنَ وصول لمؤسستك ولمنتج واحد. ويوافق عليه مسؤول ثانٍ في Birlesa؛ ولا يُفتح الوصول إلا عندئذ.
يرى مالكو مؤسستك ومديروها أذونات الوصول الخاصة بها: GET /v1/orgs/{org_id}/data-grants.
أصدِر مفتاح API (أو عميل OAuth) بصلاحية data:read.
اقرأ المنتج:

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

الإجابة بصيغة أسطر JSON (application/x-ndjson)، الأقدم أولًا. وعندما يكون هناك المزيد، تحمل الترويسة Birlesa-Next-Cursor المؤشر إلى الصفحة التالية (&cursor=...). وتسمح الخلاصات بـ 6 طلبات في الدقيقة لكل مفتاح؛ فاجلب المنتجات الشهرية مرة واحدة بعد نشرها (في اليومين الخامس والسادس من كل شهر)، والمنتج اليومي مرة واحدة في اليوم.

مراجعات الوصول

يُراجَع كل إذن وصول مرة كل 90 يومًا على الأقل: هل لا يزال العقد ساريًا، وهل تُستخدم البيانات كما اتُّفق، وهل المفاتيح في أيدي الأشخاص المناسبين؟ وإذن الوصول الذي تأخرت مراجعته يتوقف عن العمل تلقائيًا حتى تُنجَز المراجعة؛ وتتلقى الطلبات عندئذ 403 مع الرمز no_live_grant. وتُسجَّل كل قراءة مقابل العقد.

الأخطاء

الرمز	المعنى
`no_data_read` (403)	يفتقر المفتاح إلى صلاحية `data:read`
`no_live_grant` (403)	لا يوجد إذن وصول معتمد وسارٍ ومراجَع لهذا المنتج
`bad_cursor` (400)	المؤشر ليس من المؤشرات التي أعطتها الخلاصة