Workspace
Ihr Workspace ist die Arbeitseinheit in Bird. Er enthält Ihre Domains, API-Keys, Sendungen und den Teamzugriff. Das Dashboard ist Workspace-zentriert, und jede Aktion findet innerhalb Ihres Workspace statt. Ihr Konto ist an eine einzelne Region gebunden und enthält Ihre Abrechnungsinformationen.
Regionen
Ihr Konto ist an genau eine Region gebunden, derzeit us1 (USA) oder eu1 (Europäische Union). Die Region wird bei der Registrierung gewählt und kann nicht geändert werden: Ihre Daten und Sendeinfrastruktur befinden sich dort, und API-Traffic geht an den Host dieser Region, https://us1.platform.bird.com oder https://eu1.platform.bird.com. Die Region ist in jedes API-Key-Präfix eingebettet (bk_us1_...), sodass Anfragen sich selbst routen. Siehe Base URLs & Regionen für die Routing-Regeln und was mit einer Anfrage passiert, die die falsche Region erreicht.
Wie eine Anfrage Ihren Workspace findet
Die API von Bird verwendet flache Routen (/v1/email/messages, /v1/sms/messages) ohne Workspace-Segment im Pfad. Stattdessen trägt das Credential den Kontext: Ein API-Key ist an Ihren Workspace gebunden, wodurch auch Organisation und Region feststehen – eine Anfrage braucht also nichts außer dem Key selbst. Eine Anfrage, die einen Kontext angibt, der ihrem Key widerspricht, wird als fehlerhaft abgelehnt (400), statt stillschweigend uminterpretiert zu werden.
Ob die Anfrage dann erlaubt ist, ist eine separate Frage, die durch Key-Scopes für API-Keys und durch Rollen für Personen beantwortet wird, die im Dashboard arbeiten.
Konto schließen
Die Schließung Ihres Kontos ist dauerhaft und absichtlich schwer versehentlich auszulösen. Die Kontoschließung wird vom Inhaber in den Kontoeinstellungen initiiert und löst eine Bestätigungs-E-Mail aus. Bis Sie den Link bestätigen, den Bird Ihnen sendet, ändert sich nichts.
Nach der Bestätigung:
- Die Sperrung erfolgt sofort. Ihr Konto verschwindet aus dem Dashboard, seine API-Keys authentifizieren nicht mehr und werden widerrufen, der Versand stoppt, und jedes aktive Abonnement wird gekündigt.
- Es folgt ein 7-tägiges Kulanzfenster. Daten, Konfiguration und Team-Mitgliedschaften bleiben unverändert erhalten. Die Schließungs-E-Mail enthält einen Abbruch-Link, und wenn Sie ihm innerhalb des Fensters folgen, wird der Zugang wiederhergestellt. Alles kommt zurück, außer API-Keys, die bei der Sperrung widerrufen wurden und neu ausgestellt werden müssen.
- Danach ist die Löschung unwiderruflich. Nach Ablauf des Fensters läuft die Bereinigung und gibt alles frei: Domains, Unterdrückungslisten, Webhook-Endpunkte, Templates, Mitgliedschaften, Daten. Sobald die Löschung beginnt, kann nichts wiederhergestellt werden.
Nächste Schritte
- Authentifizierung & API-Keys: wie Keys an einen Workspace gebunden sind
- Benutzer, Teams & Rollen: Workspace-Rollen und Zugriffskontrolle, einschließlich Rollen auf Kontoebene für die Abrechnung
- Base URLs & Regionen: regionale Hosts und Routing
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.