L'API di Blue utilizza un sistema di autenticazione basato su token.
Intestazioni
Prima di eseguire qualsiasi query, è essenziale configurare le intestazioni per la tua richiesta API. Queste intestazioni rimangono costanti in tutte le richieste, richiedendo solo una configurazione una tantum. Servono per autenticare ogni richiesta all'API.
Le intestazioni richieste sono il Token-ID e il Secret-ID, rappresentati come x-bloo-token-id e x-bloo-token-secret rispettivamente.
Inoltre, alcune richieste potrebbero richiedere l'inclusione di un Company-ID x-bloo-company-id e di un Project-ID x-bloo-project-id per operazioni più specifiche.
Puoi scoprire come creare un token e un segreto nel seguente video:
Token ID
Il Token ID è il tuo identificatore unico per l'accesso all'API.
Per iniziare a utilizzare la nostra API, fai clic sul tuo profilo in alto a destra e, nel menu del profilo, troverai la scheda API.
Nella scheda API, fai clic sul pulsante "Genera un Token":
Fornisci un nome per il token e imposta una data di scadenza se desiderato. Se imposti una data di scadenza, il token API smetterà automaticamente di funzionare dopo quella data.
Dopo la generazione, ti verrà mostrato un Token ID e un Secret ID. Il Token ID sarà preceduto da pat_ per una facile identificazione.
Secret ID
Il Secret ID funge da password, garantendo una comunicazione sicura con l'API di Blue.
Ricorda, il Secret ID viene mostrato solo una volta per motivi di sicurezza, quindi conservalo in modo sicuro per mantenere l'accesso ai tuoi dati tramite l'API. Per la massima sicurezza, Blue memorizza il tuo segreto utilizzando l'hashing bcrypt, il che significa che anche il nostro team non può recuperare il tuo segreto in chiaro dopo la creazione.
Assicurati di mantenere sicuri il tuo Token ID e Secret ID, poiché chiunque abbia accesso a queste credenziali può accedere ai tuoi dati in Blue.
Company & Project IDs
Ecco un video che mostra come trovare il tuo company ID e project ID in Blue:
Le aziende sono l'entità di livello superiore in Blue. I Company ID vengono utilizzati per identificare un'azienda in Blue. Vengono utilizzati nell'API per specificare con quale azienda interagire. L'ID è lo stesso dello slug dell'azienda nell'URL quando visiti l'azienda in Blue:
app.blue.cc/company/{company-id}/
Per alcune query e mutazioni, sarà necessario fornire un Project ID. Questo è l'ID del progetto con cui desideri interagire. L'ID è lo stesso dello slug del progetto nell'URL quando visiti il progetto in Blue:
app.blue.cc/company/{company-id}/project/{project-id}/