Riferimento API
Ogni endpoint dell'API v1, generato dallo stesso codice che risponde alle richieste. Scarica la specifica OpenAPI 3.1 per generare un client.
Elenca i membri
get /members
Restituisce i membri dell'azienda, dal più recente.
Ambito: members:read
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
limit query | integer | Numero di elementi per pagina (1–100). |
cursor query | string | Cursore restituito come next_cursor dalla pagina precedente. |
role query | "owner" | "admin" | "manager" | "member" | Filtra per ruolo. |
email query | string (email) | Filtra per email esatta. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
object obbligatorio | "list" | |
data obbligatorio | Member[] | |
has_more obbligatorio | boolean | |
next_cursor obbligatorio | string | null |
Invita un membro
post /members
Invia un invito via email. L'invito occupa un posto finché non scade. Emette member.invited.
Ambito: members:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Idempotency-Key header | string | Chiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
email obbligatorio | string (email) | Email della persona da invitare. |
role | "admin" | "manager" | "member" | Ruolo nell'azienda. |
Risposta 201
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | "invitation" | |
email | string (email) | |
role | "admin" | "manager" | "member" | |
status | "pending" | |
expires_at | string (date-time) | |
created_at | string (date-time) |
Recupera un membro
get /members/{id}
Restituisce un membro dell'azienda.
Ambito: members:read
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id path | string | Identificativo della risorsa. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | "member" | |
user_id | string | |
name | string | |
email | string (email) | |
role | "owner" | "admin" | "manager" | "member" | |
status | "active" | "disabled" | |
created_at | string (date-time) |
Rimuove un membro
delete /members/{id}
Toglie la persona dall'azienda e libera il posto. I suoi tag restano senza membro.
Ambito: members:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id path | string | Identificativo della risorsa. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Idempotency-Key header | string | Chiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | string | |
deleted | true |
Posti dell'azienda
get /seats
Posti acquistati, usati, impegnati da inviti in attesa e liberi.
Ambito: members:read
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
object | "seats" | |
purchased | integer | |
used | integer | |
pending | integer | Inviti in attesa che occupano un posto. |
available | integer |
Elenca i tag
get /tags
Restituisce i tag dell'azienda. Con una chiave di test restituisce solo i tag demo.
Ambito: tags:read
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
limit query | integer | Numero di elementi per pagina (1–100). |
cursor query | string | Cursore restituito come next_cursor dalla pagina precedente. |
status query | "in_stock" | "assigned" | "active" | "lost" | "deactivated" | Filtra per stato. |
member query | string | Filtra per membro assegnato. |
product query | string | Filtra per prodotto. |
product_type query | "keychain" | "display" | "plate" | "totem" | "gadget" | "other" | Filtra per tipo di prodotto. |
code query | string | Filtra per codice stampato. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
object obbligatorio | "list" | |
data obbligatorio | Tag[] | |
has_more obbligatorio | boolean | |
next_cursor obbligatorio | string | null |
Recupera un tag
get /tags/{id}
Restituisce un tag dell'azienda.
Ambito: tags:read
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id path | string | Identificativo della risorsa. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | "tag" | |
code | string | Codice di 8 caratteri stampato sul tag. |
url | string (uri) | Indirizzo fisso scritto nel chip. |
email_address | string (email) | Indirizzo univoco del tag per l'azione email. |
chip_type | "ntag213" | "ntag215" | "ntag216" | "ntag424" | |
status | "in_stock" | "assigned" | "active" | "lost" | "deactivated" | |
product | object | null | |
member_id | string | null | |
action_id | string | null | |
location | Location | null | Luogo del tag, o del suo prodotto se il tag non ne ha uno. |
livemode | boolean | |
created_at | string (date-time) | |
updated_at | string (date-time) |
Assegna un tag o imposta l'azione
patch /tags/{id}
Assegna il tag a un membro (member_id) e/o imposta l'azione del tocco (action_id). null toglie il valore. Il cambio di membro emette tag.assigned.
Ambito: tags:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id path | string | Identificativo della risorsa. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Idempotency-Key header | string | Chiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
member_id | string | null | Membro a cui assegnare il tag. |
action_id | string | null | Azione eseguita al tocco. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | "tag" | |
code | string | Codice di 8 caratteri stampato sul tag. |
url | string (uri) | Indirizzo fisso scritto nel chip. |
email_address | string (email) | Indirizzo univoco del tag per l'azione email. |
chip_type | "ntag213" | "ntag215" | "ntag216" | "ntag424" | |
status | "in_stock" | "assigned" | "active" | "lost" | "deactivated" | |
product | object | null | |
member_id | string | null | |
action_id | string | null | |
location | Location | null | Luogo del tag, o del suo prodotto se il tag non ne ha uno. |
livemode | boolean | |
created_at | string (date-time) | |
updated_at | string (date-time) |
Disattiva un tag
post /tags/{id}/deactivate
Il tag smette di eseguire azioni: chi lo tocca vede una pagina neutra. Operazione definitiva via API.
Ambito: tags:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id path | string | Identificativo della risorsa. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Idempotency-Key header | string | Chiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | "tag" | |
code | string | Codice di 8 caratteri stampato sul tag. |
url | string (uri) | Indirizzo fisso scritto nel chip. |
email_address | string (email) | Indirizzo univoco del tag per l'azione email. |
chip_type | "ntag213" | "ntag215" | "ntag216" | "ntag424" | |
status | "in_stock" | "assigned" | "active" | "lost" | "deactivated" | |
product | object | null | |
member_id | string | null | |
action_id | string | null | |
location | Location | null | Luogo del tag, o del suo prodotto se il tag non ne ha uno. |
livemode | boolean | |
created_at | string (date-time) | |
updated_at | string (date-time) |
Elenca le azioni
get /actions
Azioni configurate nell'azienda, da usare come action_id di un tag.
Ambito: tags:read
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
limit query | integer | Numero di elementi per pagina (1–100). |
cursor query | string | Cursore restituito come next_cursor dalla pagina precedente. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
object obbligatorio | "list" | |
data obbligatorio | Action[] | |
has_more obbligatorio | boolean | |
next_cursor obbligatorio | string | null |
Elenca i tocchi
get /scans
Tocchi registrati, dal più recente. Filtra per periodo, tag, membro ed esito.
Ambito: scans:read
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
limit query | integer | Numero di elementi per pagina (1–100). |
cursor query | string | Cursore restituito come next_cursor dalla pagina precedente. |
from query | string (date-time) | Da questo istante (incluso), ISO 8601. |
to query | string (date-time) | Fino a questo istante (escluso), ISO 8601. |
tag query | string | Filtra per tag. |
member query | string | Filtra per membro. |
outcome query | "ok" | "tag_deactivated" | "tag_unknown" | "invalid_signature" | Filtra per esito. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
object obbligatorio | "list" | |
data obbligatorio | Scan[] | |
has_more obbligatorio | boolean | |
next_cursor obbligatorio | string | null |
Elenca gli endpoint webhook
get /webhooks
Endpoint della stessa modalità della chiave (live o test).
Ambito: webhooks:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
limit query | integer | Numero di elementi per pagina (1–100). |
cursor query | string | Cursore restituito come next_cursor dalla pagina precedente. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
object obbligatorio | "list" | |
data obbligatorio | WebhookEndpoint[] | |
has_more obbligatorio | boolean | |
next_cursor obbligatorio | string | null |
Crea un endpoint webhook
post /webhooks
Registra un indirizzo che riceve gli eventi firmati. Il segreto di firma compare solo in questa risposta.
Ambito: webhooks:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Idempotency-Key header | string | Chiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
url obbligatorio | string (uri) | Indirizzo https pubblico che riceve gli eventi. |
enabled_events obbligatorio | "tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[] | Eventi da ricevere; "*" per tutti. |
description | string | null |
Risposta 201
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | "webhook_endpoint" | |
url | string (uri) | |
description | string | null | |
enabled_events | "tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[] | |
status | "enabled" | "disabled" | |
disabled_reason | string | null | |
livemode | boolean | |
created_at | string (date-time) | |
updated_at | string (date-time) | |
secret | string | Segreto di firma whsec_…: mostrato solo ora. |
Recupera un endpoint webhook
get /webhooks/{id}
Restituisce un endpoint webhook.
Ambito: webhooks:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id path | string | Identificativo della risorsa. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | "webhook_endpoint" | |
url | string (uri) | |
description | string | null | |
enabled_events | "tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[] | |
status | "enabled" | "disabled" | |
disabled_reason | string | null | |
livemode | boolean | |
created_at | string (date-time) | |
updated_at | string (date-time) |
Modifica un endpoint webhook
patch /webhooks/{id}
Cambia indirizzo, eventi o descrizione. status=enabled riattiva un endpoint disattivato e azzera gli errori.
Ambito: webhooks:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id path | string | Identificativo della risorsa. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Idempotency-Key header | string | Chiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
url | string (uri) | Indirizzo https pubblico che riceve gli eventi. |
enabled_events | "tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[] | Eventi da ricevere; "*" per tutti. |
description | string | null | |
status | "enabled" | "disabled" |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | "webhook_endpoint" | |
url | string (uri) | |
description | string | null | |
enabled_events | "tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[] | |
status | "enabled" | "disabled" | |
disabled_reason | string | null | |
livemode | boolean | |
created_at | string (date-time) | |
updated_at | string (date-time) |
Elimina un endpoint webhook
delete /webhooks/{id}
Elimina l'endpoint e il suo registro consegne. I ritentativi in coda si fermano.
Ambito: webhooks:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id path | string | Identificativo della risorsa. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Idempotency-Key header | string | Chiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | string | |
deleted | true |
Ruota il segreto di firma
post /webhooks/{id}/rotate-secret
Crea un nuovo segreto. Il vecchio resta valido per expire_previous_in_hours ore (predefinito 24, 0 = subito): in quel periodo ogni evento porta due firme v1.
Ambito: webhooks:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id path | string | Identificativo della risorsa. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Idempotency-Key header | string | Chiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
expire_previous_in_hours | integer | Ore di validità del segreto precedente. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | "webhook_endpoint" | |
url | string (uri) | |
description | string | null | |
enabled_events | "tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[] | |
status | "enabled" | "disabled" | |
disabled_reason | string | null | |
livemode | boolean | |
created_at | string (date-time) | |
updated_at | string (date-time) | |
secret | string | Segreto di firma whsec_…: mostrato solo ora. |
Invia un evento di prova
post /webhooks/{id}/test
Invia subito un evento webhook.test firmato e restituisce l'esito della consegna. Nessun ritentativo.
Ambito: webhooks:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id path | string | Identificativo della risorsa. |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Idempotency-Key header | string | Chiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
id | string | |
object | "webhook_delivery" | |
endpoint_id | string | |
event_id | string | |
event_type | "tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "webhook.test" | |
attempt | integer | |
status | "pending" | "succeeded" | "failed" | |
response_status | integer | null | |
duration_ms | integer | null | |
error | string | null | |
next_retry_at | string (date-time) | null | |
created_at | string (date-time) |
Registro consegne
get /webhooks/{id}/deliveries
Ogni tentativo di consegna dell'endpoint, dal più recente, con codice HTTP, durata ed errore.
Ambito: webhooks:write
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id path | string | Identificativo della risorsa. |
limit query | integer | Numero di elementi per pagina (1–100). |
cursor query | string | Cursore restituito come next_cursor dalla pagina precedente. |
status query | "pending" | "succeeded" | "failed" | |
TapLogic-Version header | "2026-11-18" | Versione dell'API (data). Senza, vale l'ultima. |
Risposta 200
| Nome | Tipo | Descrizione |
|---|---|---|
object obbligatorio | "list" | |
data obbligatorio | WebhookDelivery[] | |
has_more obbligatorio | boolean | |
next_cursor obbligatorio | string | null |