Spazio di lavoro
Il tuo spazio di lavoro è l'unità operativa in Bird. Contiene i tuoi domini, le chiavi API, gli invii e l'accesso del team. La dashboard è organizzata per spazio di lavoro, e ogni azione avviene all'interno del tuo spazio di lavoro. Il tuo account è legato a una singola regione e contiene le informazioni di fatturazione.
Regioni
Il tuo account è vincolato a una sola regione, attualmente us1 (Stati Uniti) o eu1 (Unione Europea). La regione viene scelta al momento della registrazione e non può essere modificata: i tuoi dati e l'infrastruttura di invio risiedono lì, e il traffico API viene indirizzato all'host di quella regione, https://us1.platform.bird.com o https://eu1.platform.bird.com. La regione è incorporata nel prefisso di ogni chiave API (bk_us1_...), quindi le richieste si instradano automaticamente. Consulta URL di base e regioni per le regole di instradamento e per sapere cosa succede a una richiesta che raggiunge la regione sbagliata.
Come una richiesta trova il tuo spazio di lavoro
L'API di Bird usa rotte piatte (/v1/email/messages, /v1/sms/messages) senza segmento dello spazio di lavoro nel percorso. Il contesto è trasportato dalla credenziale: una chiave API è legata al tuo spazio di lavoro, il che fissa anche la sua organizzazione e la sua regione, quindi una richiesta non ha bisogno di nulla oltre alla chiave stessa. Una richiesta che indica un contesto in contraddizione con la propria chiave viene rifiutata come malformata (400) anziché reinterpretata silenziosamente.
Se la richiesta viene poi autorizzata è una questione separata, a cui rispondono gli scope delle chiavi per le chiavi API e i ruoli per le persone che lavorano nella dashboard.
Chiusura di un account
La chiusura del tuo account è permanente e deliberatamente difficile da effettuare per errore. La chiusura viene avviata dal proprietario dalle impostazioni dell'account e genera un'email di conferma. Finché non confermi seguendo il link che Bird ti invia, non cambia nulla.
Una volta confermata:
- Il blocco è immediato. Il tuo account scompare dalla dashboard, le sue chiavi API smettono di autenticarsi e vengono revocate, l'invio si interrompe e qualsiasi abbonamento attivo viene cancellato.
- Segue una finestra di grazia di 7 giorni. Dati, configurazione e appartenenze ai team vengono conservati intatti. L'email di chiusura contiene un link di annullamento: seguendolo entro la finestra si ripristina l'accesso. Tutto viene recuperato tranne le chiavi API, che sono state revocate al momento del blocco e devono essere riemesse.
- Dopodiché la cancellazione è irreversibile. Trascorsa la finestra, il processo di pulizia recupera tutto: domini, soppressioni, endpoint webhook, template, appartenenze, dati. Nulla può essere recuperato una volta iniziata la cancellazione.
Passaggi successivi
- Autenticazione e chiavi API: come le chiavi si legano a uno spazio di lavoro
- Utenti, team e ruoli: ruoli dello spazio di lavoro e controllo degli accessi, inclusi i ruoli a livello di account per la fatturazione
- URL di base e regioni: host regionali e instradamento
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.