Getting started
Authentication
Every request must carry an API key in the Authorization header:
GET /api/v1/siparisler HTTP/1.1
Host: panel.bulutegra.com
Authorization: Bearer btg_<hesap>_<anahtar>Key format
Keys start with btg_, followed by your account code and a 48-character random part. Bulutegra does not store the key itself, only its SHA-256 hash, so a lost key cannot be recovered — create a new one and revoke the old one.
Scopes
| Scope | What it returns |
|---|---|
temel | Order, product, stock and channel data; no personal data. |
kisisel | Everything above plus musteri (customer name) on orders. You are responsible for it under data protection law; use it only when you really need it. |
Managing keys
- Up to 10 active keys per account.
- The panel shows each key's last use and request count.
- Revoke takes effect immediately; the next request with that key gets
401. - Creating and revoking keys is recorded in the panel's activity log (the key itself is never logged).
Last updated: 2026-10-07