Autenticazione
Ogni richiesta porta una chiave API dell'azienda nell'intestazione Authorization, con lo schema Bearer.
curl "https://api.taplogic.it/v1/members" \
-H "Authorization: Bearer $TAPLOGIC_API_KEY"Chiavi live e chiavi test
Le chiavi tl_live_… lavorano sui dati veri. Le chiavi tl_test_… vedono solo i tag demo e i loro tocchi, ricevono gli eventi sugli endpoint di test e non invitano né rimuovono persone. Il codice è lo stesso: cambia solo la chiave.
Ambiti
Ogni chiave ha solo gli ambiti scelti alla creazione. Una richiesta fuori ambito risponde 403 insufficient_scope e il campo param indica l'ambito mancante.
| Ambito | Cosa permette |
|---|---|
tags:read | Leggere tag e azioni (GET /tags, GET /actions). |
tags:write | Assegnare un tag, impostare l'azione, disattivarlo. |
members:read | Leggere membri e posti (GET /members, GET /seats). |
members:write | Invitare e rimuovere membri. Solo chiavi live. |
scans:read | Leggere i tocchi (GET /scans). |
webhooks:write | Creare, modificare, provare ed eliminare endpoint webhook. |
Custodire le chiavi
- La chiave compare una sola volta, alla creazione. TapLogic conserva solo un'impronta (hash): nessuno può rileggerla.
- Usala solo dal tuo server. Mai in un'app mobile, in una pagina web o in un repository.
- Una chiave per sistema, con il minimo degli ambiti: se un sistema viene compromesso, revochi solo quella.
- La revoca in Impostazioni → API e webhook ha effetto immediato.
Chiave mancante o non valida
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="TapLogic"
{
"error": {
"code": "invalid_api_key",
"message": "La chiave API non è valida, è scaduta o è stata revocata.",
"doc_url": "https://docs.taplogic.it/it/errors#invalid_api_key",
"request_id": "req_Qm3Xc81ZpRt0aBcYvWsK"
}
}