De Data API van bluebarry staat op https://data.bluebarry.ai/data. Hij accepteert drie soorten inloggegevens. Welke je nodig hebt, hangt af van waar je code draait en voor wie die handelt.
Kies een methode
| Methode | Hoe je het meestuurt | Gebruik je voor |
|---|---|---|
| API-sleutel | De sleutel zelf in de Authorization-header, zonder Bearer-prefix. | Je eigen servers en automatiseringen. Leest en schrijft de data van je account, bijvoorbeeld profielen, producten, klanten en bestellingen. |
| OAuth-token | Authorization: Bearer <token> | Apps die namens een ingelogde bluebarry-gebruiker handelen, en AI-clients die verbinding maken met de MCP-server van bluebarry. |
| Tenant ID | De header BB-Tenant-Id. | Alleen aanroepen vanuit je webshop: een bezoeker identificeren, en conversies, paginaweergaven, productweergaven en winkelwagenevents versturen. Je Tenant ID is niet geheim. |
Bevat een request BB-Tenant-Id, dan behandelt bluebarry het als aanroep vanuit de webshop, ook als er een Authorization-header bij zit. Laat die header weg bij serveraanroepen met een API-sleutel of token.
Waar je ze vindt
- API-sleutels: Integrations → Developer area → API keys management. Zie API-sleutels beheren.
- Tenant ID: bovenaan de pagina Integrations, met een kopieerknop.
- OAuth: zie OAuth gebruiken met bluebarry.
- De volledige endpointreferentie vind je via de link API docs in de Developer area.
Houd inloggegevens veilig
- Bewaar API-sleutels en tokens op je server of in een secret manager. Zet ze nooit in JavaScript van je webshop of in een openbare repository.
- Maak één sleutel per integratie, zodat je er een kunt verwijderen zonder de andere te breken.
- Verwijder sleutels die je niet meer gebruikt, en vervang een sleutel als iemand die hem kende het project verlaat.