Veri ürünleri

Bankalar, birlikler, kamu kurumları ve büyük şirketler, Birlesa'nın toplulaştırılmış veri setlerini sözleşmeyle ve toplu olarak alabilir. Her ürün, platformun zaten yayımladığı ya da kendi kurallarıyla toplulaştırdığı verilerden oluşturulur. Bu kuralların izin verdiğinden daha ayrıntılı ya da daha kişisel hiçbir şey teslim edilmez.

GET /v1/data/products bunları her kaydın alanlarıyla birlikte listeler. /v1 içinde alanlar yalnızca eklenir; asla değiştirilmez ya da kaldırılmaz.

Erişim

1. Bir sözleşme imzalanır. Birlesa bunu, kuruluşunuz ve tek bir ürün için bir erişim yetkisi olarak kaydeder. Birlesa'dan ikinci bir yetkili onaylar; ancak o zaman erişim açılır.
2. Kuruluşunuzun sahipleri ve yöneticileri kuruluşun erişim yetkilerini görür: GET /v1/orgs/{org_id}/data-grants.
3. data:read izinli bir API anahtarı (ya da OAuth istemcisi) oluşturun.
4. Ürünü okuyun:

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

Yanıt JSON satırlarıdır (application/x-ndjson), en eskisi önce. Devamı olduğunda Birlesa-Next-Cursor başlığı sonraki sayfanın imlecini taşır (&cursor=...). Akışlar anahtar başına dakikada 6 isteğe izin verir; aylık ürünleri yayımlandıktan sonra bir kez (her ayın 5'i ve 6'sı), günlük ürünü ise günde bir kez çekin.

Erişim incelemeleri

Her erişim yetkisi en az 90 günde bir incelenir: sözleşme hâlâ yürürlükte mi, veriler kararlaştırıldığı gibi mi kullanılıyor, anahtarlar doğru kişilerin elinde mi? İncelemesi geciken bir erişim yetkisi, inceleme yapılana kadar kendiliğinden çalışmayı bırakır; istekler o sırada no_live_grant koduyla 403 alır. Her okuma sözleşmeye bağlı olarak kaydedilir.

Hatalar