Genuka WA docs

Autenticazione

Chiavi API, ambito e buone pratiche di rotazione.

Ogni richiesta si autentica con una chiave API nell'header Authorization:

Authorization: Bearer pk_live_...

Non maneggi mai un token di Meta. Genuka WA custodisce le credenziali della Cloud API e le ruota al posto tuo: basta una sola chiave API di Genuka, e dà accesso solo ai tuoi dati.

Due ambiti di chiave

AmbitoAccessoCaso d'uso
PartnerTutti i clienti del partnerUna piattaforma che gestisce numeri per più aziende
ClienteUna sola aziendaUn'azienda che integra solo i propri numeri

Una chiave cliente che tenta di accedere a un'altra azienda riceve 403 out_of_scope. Alcuni endpoint (fatturazione, utilizzo del piano) richiedono una chiave partner e altrimenti rispondono 403 partner_key_required.

Creare e revocare una chiave

Le chiavi si gestiscono dal portale, in Sviluppatori. Una chiave viene mostrata una sola volta alla creazione: Genuka ne conserva solo un'impronta e non può mostrartela di nuovo.

Per ruotare senza interruzioni del servizio: crea la nuova chiave, distribuiscila, verifica il traffico nei log, poi revoca quella vecchia.

Risposte di errore

StatoCodiceSignificato
401missing_bearer_tokenManca l'header Authorization
401invalid_tokenChiave sconosciuta o revocata
403out_of_scopeLa chiave è limitata a un'altra azienda
403partner_key_requiredEndpoint riservato alle chiavi partner

Sicurezza

  • Una chiave API è un segreto lato server. Non includerla mai in un frontend o in un'app mobile: chiunque potrebbe inviare messaggi a tuo nome, a tue spese.
  • Usa chiavi distinte per ambiente e per integrazione: così la revoca diventa un'operazione chirurgica anziché globale.
  • Ogni richiesta viene registrata ed è visibile nel portale.

In questa pagina