Vai al contenuto
TapLogic API
English

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.

AmbitoCosa permette
tags:readLeggere tag e azioni (GET /tags, GET /actions).
tags:writeAssegnare un tag, impostare l'azione, disattivarlo.
members:readLeggere membri e posti (GET /members, GET /seats).
members:writeInvitare e rimuovere membri. Solo chiavi live.
scans:readLeggere i tocchi (GET /scans).
webhooks:writeCreare, 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"
  }
}