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.

Aby zmienić nazwę bieżącego obszaru roboczego, otwórz Settings > General, edytuj pole Name, a następnie opuść je, aby zapisać zmianę. Edycja wymaga uprawnień do zarządzania tym obszarem roboczym.

Aby utworzyć kolejny obszar roboczy, otwórz stronę Workspaces swojej organizacji i wybierz Create workspace. Wpisz Workspace name i potwierdź. Dostępność zależy od uprawnień Twojej organizacji i limitu obszarów roboczych; jeśli tworzenie jest wyłączone, sprawdź wyświetlony powód. Przełączenie się na istniejący obszar roboczy nie tworzy nowego.

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 organizacji

Zamknięcie organizacji jest trwałe i celowo trudne do wykonania przez przypadek. Zamknięcie zleca właściciel, a Bird wysyła e-mailem link potwierdzający. Dopóki nie potwierdzisz, klikając ten link, nic się nie zmieni. Aby zamknąć własne konto użytkownika zamiast organizacji, zobacz Zamknij konto.

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 usuwa wszystko: domeny, suppresje, 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