Workspace
Workspace Anda adalah unit kerja di Bird. Workspace menyimpan domain, kunci API, pengiriman, dan akses tim Anda. Dashboard mengutamakan workspace, dan setiap tindakan berlangsung di dalam workspace Anda. Akun Anda terikat pada satu region dan menyimpan informasi tagihan Anda.
Untuk mengganti nama workspace saat ini, buka Settings > General, ubah Name, lalu tinggalkan kolom tersebut untuk menyimpan. Pengeditan memerlukan izin untuk mengelola workspace tersebut.
Untuk membuat workspace lain, buka halaman Workspaces organisasi Anda dan pilih Create workspace. Masukkan Workspace name lalu konfirmasi. Ketersediaannya bergantung pada akses dan batas workspace organisasi Anda. Jika pembuatan dinonaktifkan, periksa alasan yang ditampilkan. Beralih ke workspace yang sudah ada tidak membuat workspace baru.
Region
Akun Anda terpasang pada tepat satu region, saat ini us1 (Amerika Serikat) atau eu1 (Uni Eropa). Region dipilih saat pendaftaran dan tidak dapat diubah: data dan infrastruktur pengiriman Anda berada di sana, dan lalu lintas API menuju host region tersebut, https://us1.platform.bird.com atau https://eu1.platform.bird.com. Region tertanam dalam setiap prefiks kunci API (bk_us1_...), sehingga permintaan ter-routing secara otomatis. Lihat Base URL & region untuk aturan routing dan apa yang terjadi pada permintaan yang mencapai region yang salah.
Bagaimana permintaan menemukan workspace Anda
API Bird menggunakan rute datar (/v1/email/messages, /v1/sms/messages) tanpa segmen workspace di path. Kredensial yang membawa konteksnya: kunci API terikat ke workspace Anda, yang sekaligus menetapkan organisasi dan regionnya, sehingga permintaan tidak memerlukan apa pun selain kunci itu sendiri. Permintaan yang menyebutkan konteks yang bertentangan dengan kuncinya akan ditolak sebagai permintaan cacat (400), bukan diinterpretasikan ulang secara diam-diam.
Apakah permintaan tersebut kemudian diizinkan adalah pertanyaan terpisah, dijawab oleh cakupan kunci untuk kunci API dan oleh peran untuk orang yang bekerja di dashboard.
Menutup organisasi
Menutup organisasi bersifat permanen dan sengaja dirancang agar sulit dilakukan secara tidak sengaja. Pemilik mengajukan penutupan, lalu Bird mengirimkan tautan konfirmasi melalui email. Sampai Anda mengonfirmasi dengan mengikuti tautan tersebut, tidak ada yang berubah. Untuk menutup akun pengguna Anda sendiri, bukan organisasi, lihat Menutup akun Anda.
Setelah dikonfirmasi:
- Penguncian berlaku segera. Akun Anda menghilang dari dashboard, kunci API-nya berhenti melakukan autentikasi dan dicabut, pengiriman berhenti, dan langganan aktif apa pun dibatalkan.
- Selanjutnya ada masa tenggang 7 hari. Data, konfigurasi, dan keanggotaan tim disimpan tanpa perubahan. Email penutupan berisi tautan pembatalan, dan akses dipulihkan jika Anda mengikutinya selama masa tenggang. Semuanya kembali kecuali kunci API, yang telah dicabut saat penguncian dan harus diterbitkan ulang.
- Kemudian penghapusan tidak dapat dibatalkan. Setelah masa tenggang berakhir, proses pembersihan berjalan dan menghapus semuanya: domain, supresi, endpoint webhook, template, keanggotaan, dan data. Tidak ada yang dapat dipulihkan begitu penghapusan dimulai.
Langkah selanjutnya
- Autentikasi & kunci API: bagaimana kunci terikat pada workspace
- Pengguna, tim & peran: peran workspace dan kontrol akses, termasuk peran tingkat akun untuk tagihan
- Base URL & region: host regional dan routing
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.