Obszar roboczy
Twój obszar roboczy to jednostka pracy w Bird. Zawiera domeny, klucze API, wysyłki i dostęp zespołu. Dashboard jest zorientowany na obszar roboczy, a każde działanie odbywa się w jego ramach. Twoje konto jest przypisane do jednego regionu i przechowuje dane rozliczeniowe.
Regiony
Konto jest przypisane do dokładnie jednego regionu, obecnie us1 (Stany Zjednoczone) lub eu1 (Unia Europejska). Region jest wybierany przy rejestracji i nie można go zmienić: dane i infrastruktura wysyłkowa znajdują się w nim, a ruch API trafia do hosta danego regionu, https://us1.platform.bird.com lub https://eu1.platform.bird.com. Region jest wbudowany w prefiks każdego klucza API (bk_us1_...), więc żądania kierują się same. Zobacz Bazowe adresy URL i regiony, aby poznać reguły routingu i dowiedzieć się, co dzieje się z żądaniem, które trafia do niewłaściwego regionu.
Jak żądanie znajduje Twój obszar roboczy
API Bird używa płaskich tras (/v1/email/messages, /v1/sms/messages) bez segmentu obszaru roboczego w ścieżce. Kontekst przenosi poświadczenie: klucz API jest powiązany z Twoim obszarem roboczym, co ustala też jego organizację i region, więc żądanie nie potrzebuje niczego poza samym kluczem. Żądanie wskazujące kontekst sprzeczny z kluczem jest odrzucane jako nieprawidłowe (400), a nie cicho reinterpretowane.
To, czy żądanie jest następnie dozwolone, to osobna kwestia. Odpowiadają na nią zakresy kluczy w przypadku kluczy API oraz role w przypadku osób pracujących w dashboardzie.
Zamykanie konta
Zamknięcie konta jest trwałe i celowo trudne do wykonania przez przypadek. Zamknięcie inicjuje właściciel z poziomu ustawień konta, co wywołuje wysłanie e-maila z potwierdzeniem. Dopóki nie potwierdzisz, klikając link, który Bird Ci wyśle, nic się nie zmieni.
Po potwierdzeniu:
- Blokada następuje natychmiast. Konto znika z dashboardu, klucze API przestają uwierzytelniać i są unieważniane, wysyłka zostaje wstrzymana, a każda aktywna subskrypcja jest anulowana.
- Następuje 7-dniowe okno przywrócenia. Dane, konfiguracja i członkostwa w zespołach pozostają nienaruszone. E-mail o zamknięciu zawiera link anulujący. Kliknięcie go w tym oknie przywraca dostęp. Wszystko wraca z wyjątkiem kluczy API, które zostały unieważnione przy blokadzie i trzeba je wydać ponownie.
- Następnie usunięcie jest nieodwracalne. Po upływie okna uruchamia się czyszczenie, które odzyskuje wszystko: domeny, listy wykluczeń, endpointy webhooków, szablony, członkostwa, dane. Po rozpoczęciu usuwania nic nie da się odzyskać.
Kolejne kroki
- Uwierzytelnianie i klucze API: jak klucze wiążą się z obszarem roboczym
- Użytkownicy, zespoły i role: role w obszarze roboczym i kontrola dostępu, w tym role na poziomie konta do zarządzania rozliczeniami
- Bazowe adresy URL i regiony: hosty regionalne i routing
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.