Espace de travail
Votre espace de travail est l'unité de travail dans Bird. Il contient vos domaines, vos clés API, vos envois et vos accès d'équipe. Le tableau de bord est centré sur l'espace de travail, et chaque action s'effectue au sein de votre espace de travail. Votre compte est rattaché à une seule région et contient vos informations de facturation.
Régions
Votre compte est lié à une seule région, actuellement us1 (États-Unis) ou eu1 (Union européenne). La région est choisie à l'inscription et ne peut pas être modifiée : vos données et votre infrastructure d'envoi y résident, et le trafic API est dirigé vers l'hôte de cette région, https://us1.platform.bird.com ou https://eu1.platform.bird.com. La région est intégrée dans le préfixe de chaque clé API (bk_us1_...), de sorte que les requêtes se routent d'elles-mêmes. Consultez URL de base et régions pour les règles de routage et ce qui se passe lorsqu'une requête atteint la mauvaise région.
Comment une requête trouve votre espace de travail
L'API de Bird utilise des routes plates (/v1/email/messages, /v1/sms/messages) sans segment d'espace de travail dans le chemin. C'est l'identifiant qui porte le contexte : une clé API est liée à votre espace de travail, ce qui fixe aussi son organisation et sa région, et une requête n'a besoin de rien d'autre que la clé elle-même. Une requête qui désigne un contexte en contradiction avec sa clé est rejetée comme malformée (400) au lieu d'être réinterprétée silencieusement.
La question de savoir si la requête est ensuite autorisée est distincte, résolue par les portées de clé pour les clés API et par les rôles pour les personnes travaillant dans le tableau de bord.
Fermeture d'un compte
La fermeture de votre compte est définitive et volontairement difficile à déclencher par accident. La fermeture est initiée par le propriétaire depuis les paramètres du compte et déclenche un e-mail de confirmation. Tant que vous n'avez pas confirmé en suivant le lien que Bird vous envoie, rien ne change.
Une fois la confirmation effectuée :
- Le verrouillage est immédiat. Votre compte disparaît du tableau de bord, ses clés API cessent de s'authentifier et sont révoquées, les envois s'arrêtent et tout abonnement actif est annulé.
- Un délai de grâce de 7 jours suit. Les données, la configuration et les appartenances d'équipe sont conservées intactes. L'e-mail de fermeture contient un lien d'annulation : en le suivant dans ce délai, vous restaurez l'accès. Tout est rétabli sauf les clés API, qui ont été révoquées au verrouillage et doivent être régénérées.
- La purge est ensuite irréversible. Après le délai, un nettoyage s'exécute et récupère tout : domaines, suppressions, points de terminaison webhook, modèles, appartenances, données. Rien ne peut être récupéré une fois la purge commencée.
Étapes suivantes
- Authentification et clés API : comment les clés sont liées à un espace de travail
- Utilisateurs, équipes et rôles : rôles de l'espace de travail et contrôle d'accès, y compris les rôles au niveau du compte pour la facturation
- URL de base et régions : hôtes régionaux et routage
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.