Werkruimte
Je werkruimte is de werkeenheid in Bird. Deze bevat je domeinen, API-sleutels, verzendingen en teamtoegang. Het dashboard is werkruimte-georiënteerd en elke actie vindt plaats binnen je werkruimte. Je account is gekoppeld aan één regio en bevat je factureringsgegevens.
Regio's
Je account is vastgepind aan precies één regio, momenteel us1 (Verenigde Staten) of eu1 (Europese Unie). De regio wordt gekozen bij registratie en kan niet worden gewijzigd: je data en verzendinfrastructuur bevinden zich daar, en API-verkeer gaat naar de host van die regio, https://us1.platform.bird.com of https://eu1.platform.bird.com. De regio zit ingebakken in elk API-sleutelprefix (bk_us1_...), waardoor verzoeken zichzelf routeren. Zie Basis-URL's & regio's voor de routeringsregels en wat er gebeurt met een verzoek dat bij de verkeerde regio terechtkomt.
Hoe een verzoek je werkruimte vindt
De API van Bird gebruikt platte routes (/v1/email/messages, /v1/sms/messages) zonder werkruimtesegment in het pad. De credential draagt in plaats daarvan de context: een API-sleutel is gebonden aan je werkruimte, waarmee ook de organisatie en regio vastliggen, dus een verzoek heeft niets meer nodig dan de sleutel zelf. Een verzoek dat een context noemt die in tegenspraak is met de sleutel wordt afgewezen als onjuist gevormd (400) in plaats van stilzwijgend geherinterpreteerd.
Of het verzoek vervolgens wordt toegestaan is een aparte vraag, beantwoord door sleutelbereiken voor API-sleutels en door rollen voor mensen die in het dashboard werken.
Een account sluiten
Het sluiten van je account is permanent en opzettelijk moeilijk om per ongeluk te doen. Accountsluiting wordt door de eigenaar gestart vanuit de accountinstellingen en activeert een bevestigingsmail. Zolang je niet bevestigt door op de link te klikken die Bird je stuurt, verandert er niets.
Na bevestiging:
- Uitsluiting is onmiddellijk. Je account verdwijnt uit het dashboard, de API-sleutels stoppen met authenticeren en worden ingetrokken, verzending stopt en een actief abonnement wordt opgezegd.
- Daarna volgt een respijtperiode van 7 dagen. Data, configuratie en teamlidmaatschappen blijven onaangetast bewaard. De sluitingsmail bevat een annuleringslink; als je deze binnen de periode volgt, wordt de toegang hersteld. Alles komt terug behalve API-sleutels, die bij uitsluiting zijn ingetrokken en opnieuw moeten worden uitgegeven.
- Daarna is de verwijdering onomkeerbaar. Na de respijtperiode wordt een opschoonproces uitgevoerd dat alles terugvordert: domeinen, suppressies, webhook-endpoints, templates, lidmaatschappen, data. Niets kan worden hersteld zodra de verwijdering begint.
Volgende stappen
- Authenticatie & API-sleutels: hoe sleutels aan een werkruimte zijn gebonden
- Gebruikers, teams & rollen: werkruimterollen en toegangsbeheer, inclusief rollen op accountniveau voor facturering
- Basis-URL's & regio's: regionale hosts en routering
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.