Espaço de trabalho
Seu espaço de trabalho é a unidade de trabalho no Bird. Ele contém seus domínios, chaves API, envios e acesso de equipe. O dashboard é organizado por espaço de trabalho, e toda ação acontece dentro do seu espaço de trabalho. Sua conta está vinculada a uma única região e contém suas informações de faturamento.
Regiões
Sua conta está fixada em exatamente uma região, atualmente us1 (Estados Unidos) ou eu1 (União Europeia). A região é escolhida no cadastro e não pode ser alterada: seus dados e infraestrutura de envio ficam lá, e o tráfego API vai para o host dessa região, https://us1.platform.bird.com ou https://eu1.platform.bird.com. A região está embutida em cada prefixo de chave API (bk_us1_...), então as requisições se roteiam sozinhas. Consulte URLs base e regiões para as regras de roteamento e o que acontece com uma requisição que chega à região errada.
Como uma requisição encontra seu espaço de trabalho
A API de Bird usa rotas planas (/v1/email/messages, /v1/sms/messages) sem segmento de espaço de trabalho no caminho. A credencial carrega o contexto: uma chave API está vinculada ao seu espaço de trabalho, o que também define sua organização e região, então uma requisição não precisa de nada além da própria chave. Uma requisição que indica um contexto em contradição com sua chave é rejeitada como malformada (400), em vez de ser reinterpretada silenciosamente.
Se a requisição é então permitida é uma questão separada, respondida por escopos de chave para chaves API e por papéis para pessoas que trabalham no dashboard.
Encerrando uma conta
Encerrar sua conta é permanente e deliberadamente difícil de fazer por acidente. O encerramento é iniciado pelo proprietário nas configurações da conta e dispara um e-mail de confirmação. Até você confirmar seguindo o link que Bird envia, nada muda.
Após a confirmação:
- O bloqueio é imediato. Sua conta desaparece do dashboard, suas chaves API param de autenticar e são revogadas, os envios param, e qualquer assinatura ativa é cancelada.
- Uma janela de carência de 7 dias se segue. Dados, configuração e membros de equipe são mantidos intactos. O e-mail de encerramento contém um link de cancelamento, e segui-lo dentro da janela restaura o acesso. Tudo volta, exceto as chaves API, que foram revogadas no bloqueio e precisam ser reemitidas.
- Depois disso, a exclusão é irreversível. Após a janela, a limpeza é executada e recupera tudo: domínios, supressões, endpoints de webhook, templates, membros, dados. Nada pode ser recuperado após o início da exclusão.
Próximos passos
- Autenticação e chaves API: como as chaves se vinculam a um espaço de trabalho
- Usuários, equipes e papéis: papéis e controle de acesso do espaço de trabalho, incluindo papéis de nível de conta para faturamento
- URLs base e regiões: hosts regionais e roteamento
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.