Vai al contenuto
TapLogic API
English

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.

Specifica OpenAPI (JSON)

Elenca i membri

get /members

Restituisce i membri dell'azienda, dal più recente.

Ambito: members:read

Parametri

NomeTipoDescrizione
limit queryintegerNumero di elementi per pagina (1–100).
cursor querystringCursore restituito come next_cursor dalla pagina precedente.
role query"owner" | "admin" | "manager" | "member"Filtra per ruolo.
email querystring (email)Filtra per email esatta.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.

Risposta 200

NomeTipoDescrizione
object obbligatorio"list"
data obbligatorioMember[]
has_more obbligatorioboolean
next_cursor obbligatoriostring | null
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

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

NomeTipoDescrizione
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.
Idempotency-Key headerstringChiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore.

Corpo della richiesta

NomeTipoDescrizione
email obbligatoriostring (email)Email della persona da invitare.
role"admin" | "manager" | "member"Ruolo nell'azienda.

Risposta 201

NomeTipoDescrizione
idstring
object"invitation"
emailstring (email)
role"admin" | "manager" | "member"
status"pending"
expires_atstring (date-time)
created_atstring (date-time)
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

Recupera un membro

get /members/{id}

Restituisce un membro dell'azienda.

Ambito: members:read

Parametri

NomeTipoDescrizione
id pathstringIdentificativo della risorsa.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.

Risposta 200

NomeTipoDescrizione
idstring
object"member"
user_idstring
namestring
emailstring (email)
role"owner" | "admin" | "manager" | "member"
status"active" | "disabled"
created_atstring (date-time)
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

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

NomeTipoDescrizione
id pathstringIdentificativo della risorsa.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.
Idempotency-Key headerstringChiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore.

Risposta 200

NomeTipoDescrizione
idstring
objectstring
deletedtrue
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

Posti dell'azienda

get /seats

Posti acquistati, usati, impegnati da inviti in attesa e liberi.

Ambito: members:read

Parametri

NomeTipoDescrizione
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.

Risposta 200

NomeTipoDescrizione
object"seats"
purchasedinteger
usedinteger
pendingintegerInviti in attesa che occupano un posto.
availableinteger
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

Elenca i tag

get /tags

Restituisce i tag dell'azienda. Con una chiave di test restituisce solo i tag demo.

Ambito: tags:read

Parametri

NomeTipoDescrizione
limit queryintegerNumero di elementi per pagina (1–100).
cursor querystringCursore restituito come next_cursor dalla pagina precedente.
status query"in_stock" | "assigned" | "active" | "lost" | "deactivated"Filtra per stato.
member querystringFiltra per membro assegnato.
product querystringFiltra per prodotto.
product_type query"keychain" | "display" | "plate" | "totem" | "gadget" | "other"Filtra per tipo di prodotto.
code querystringFiltra per codice stampato.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.

Risposta 200

NomeTipoDescrizione
object obbligatorio"list"
data obbligatorioTag[]
has_more obbligatorioboolean
next_cursor obbligatoriostring | null
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

Recupera un tag

get /tags/{id}

Restituisce un tag dell'azienda.

Ambito: tags:read

Parametri

NomeTipoDescrizione
id pathstringIdentificativo della risorsa.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.

Risposta 200

NomeTipoDescrizione
idstring
object"tag"
codestringCodice di 8 caratteri stampato sul tag.
urlstring (uri)Indirizzo fisso scritto nel chip.
email_addressstring (email)Indirizzo univoco del tag per l'azione email.
chip_type"ntag213" | "ntag215" | "ntag216" | "ntag424"
status"in_stock" | "assigned" | "active" | "lost" | "deactivated"
productobject | null
member_idstring | null
action_idstring | null
locationLocation | nullLuogo del tag, o del suo prodotto se il tag non ne ha uno.
livemodeboolean
created_atstring (date-time)
updated_atstring (date-time)
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

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

NomeTipoDescrizione
id pathstringIdentificativo della risorsa.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.
Idempotency-Key headerstringChiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore.

Corpo della richiesta

NomeTipoDescrizione
member_idstring | nullMembro a cui assegnare il tag.
action_idstring | nullAzione eseguita al tocco.

Risposta 200

NomeTipoDescrizione
idstring
object"tag"
codestringCodice di 8 caratteri stampato sul tag.
urlstring (uri)Indirizzo fisso scritto nel chip.
email_addressstring (email)Indirizzo univoco del tag per l'azione email.
chip_type"ntag213" | "ntag215" | "ntag216" | "ntag424"
status"in_stock" | "assigned" | "active" | "lost" | "deactivated"
productobject | null
member_idstring | null
action_idstring | null
locationLocation | nullLuogo del tag, o del suo prodotto se il tag non ne ha uno.
livemodeboolean
created_atstring (date-time)
updated_atstring (date-time)
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

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

NomeTipoDescrizione
id pathstringIdentificativo della risorsa.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.
Idempotency-Key headerstringChiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore.

Risposta 200

NomeTipoDescrizione
idstring
object"tag"
codestringCodice di 8 caratteri stampato sul tag.
urlstring (uri)Indirizzo fisso scritto nel chip.
email_addressstring (email)Indirizzo univoco del tag per l'azione email.
chip_type"ntag213" | "ntag215" | "ntag216" | "ntag424"
status"in_stock" | "assigned" | "active" | "lost" | "deactivated"
productobject | null
member_idstring | null
action_idstring | null
locationLocation | nullLuogo del tag, o del suo prodotto se il tag non ne ha uno.
livemodeboolean
created_atstring (date-time)
updated_atstring (date-time)
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

Elenca le azioni

get /actions

Azioni configurate nell'azienda, da usare come action_id di un tag.

Ambito: tags:read

Parametri

NomeTipoDescrizione
limit queryintegerNumero di elementi per pagina (1–100).
cursor querystringCursore restituito come next_cursor dalla pagina precedente.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.

Risposta 200

NomeTipoDescrizione
object obbligatorio"list"
data obbligatorioAction[]
has_more obbligatorioboolean
next_cursor obbligatoriostring | null
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

Elenca i tocchi

get /scans

Tocchi registrati, dal più recente. Filtra per periodo, tag, membro ed esito.

Ambito: scans:read

Parametri

NomeTipoDescrizione
limit queryintegerNumero di elementi per pagina (1–100).
cursor querystringCursore restituito come next_cursor dalla pagina precedente.
from querystring (date-time)Da questo istante (incluso), ISO 8601.
to querystring (date-time)Fino a questo istante (escluso), ISO 8601.
tag querystringFiltra per tag.
member querystringFiltra 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

NomeTipoDescrizione
object obbligatorio"list"
data obbligatorioScan[]
has_more obbligatorioboolean
next_cursor obbligatoriostring | null
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

Elenca gli endpoint webhook

get /webhooks

Endpoint della stessa modalità della chiave (live o test).

Ambito: webhooks:write

Parametri

NomeTipoDescrizione
limit queryintegerNumero di elementi per pagina (1–100).
cursor querystringCursore restituito come next_cursor dalla pagina precedente.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.

Risposta 200

NomeTipoDescrizione
object obbligatorio"list"
data obbligatorioWebhookEndpoint[]
has_more obbligatorioboolean
next_cursor obbligatoriostring | null
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

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

NomeTipoDescrizione
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.
Idempotency-Key headerstringChiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore.

Corpo della richiesta

NomeTipoDescrizione
url obbligatoriostring (uri)Indirizzo https pubblico che riceve gli eventi.
enabled_events obbligatorio"tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[]Eventi da ricevere; "*" per tutti.
descriptionstring | null

Risposta 201

NomeTipoDescrizione
idstring
object"webhook_endpoint"
urlstring (uri)
descriptionstring | null
enabled_events"tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[]
status"enabled" | "disabled"
disabled_reasonstring | null
livemodeboolean
created_atstring (date-time)
updated_atstring (date-time)
secretstringSegreto di firma whsec_…: mostrato solo ora.
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

Recupera un endpoint webhook

get /webhooks/{id}

Restituisce un endpoint webhook.

Ambito: webhooks:write

Parametri

NomeTipoDescrizione
id pathstringIdentificativo della risorsa.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.

Risposta 200

NomeTipoDescrizione
idstring
object"webhook_endpoint"
urlstring (uri)
descriptionstring | null
enabled_events"tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[]
status"enabled" | "disabled"
disabled_reasonstring | null
livemodeboolean
created_atstring (date-time)
updated_atstring (date-time)
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

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

NomeTipoDescrizione
id pathstringIdentificativo della risorsa.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.
Idempotency-Key headerstringChiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore.

Corpo della richiesta

NomeTipoDescrizione
urlstring (uri)Indirizzo https pubblico che riceve gli eventi.
enabled_events"tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[]Eventi da ricevere; "*" per tutti.
descriptionstring | null
status"enabled" | "disabled"

Risposta 200

NomeTipoDescrizione
idstring
object"webhook_endpoint"
urlstring (uri)
descriptionstring | null
enabled_events"tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[]
status"enabled" | "disabled"
disabled_reasonstring | null
livemodeboolean
created_atstring (date-time)
updated_atstring (date-time)
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

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

NomeTipoDescrizione
id pathstringIdentificativo della risorsa.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.
Idempotency-Key headerstringChiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore.

Risposta 200

NomeTipoDescrizione
idstring
objectstring
deletedtrue
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

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

NomeTipoDescrizione
id pathstringIdentificativo della risorsa.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.
Idempotency-Key headerstringChiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore.

Corpo della richiesta

NomeTipoDescrizione
expire_previous_in_hoursintegerOre di validità del segreto precedente.

Risposta 200

NomeTipoDescrizione
idstring
object"webhook_endpoint"
urlstring (uri)
descriptionstring | null
enabled_events"tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "*"[]
status"enabled" | "disabled"
disabled_reasonstring | null
livemodeboolean
created_atstring (date-time)
updated_atstring (date-time)
secretstringSegreto di firma whsec_…: mostrato solo ora.
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

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

NomeTipoDescrizione
id pathstringIdentificativo della risorsa.
TapLogic-Version header"2026-11-18"Versione dell'API (data). Senza, vale l'ultima.
Idempotency-Key headerstringChiave unica per ritentare una scrittura senza duplicarla. Valida 24 ore.

Risposta 200

NomeTipoDescrizione
idstring
object"webhook_delivery"
endpoint_idstring
event_idstring
event_type"tag.scanned" | "tag.assigned" | "member.invited" | "member.joined" | "webhook.test"
attemptinteger
status"pending" | "succeeded" | "failed"
response_statusinteger | null
duration_msinteger | null
errorstring | null
next_retry_atstring (date-time) | null
created_atstring (date-time)
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.

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

NomeTipoDescrizione
id pathstringIdentificativo della risorsa.
limit queryintegerNumero di elementi per pagina (1–100).
cursor querystringCursore 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

NomeTipoDescrizione
object obbligatorio"list"
data obbligatorioWebhookDelivery[]
has_more obbligatorioboolean
next_cursor obbligatoriostring | null
Prova
Usa una chiave tl_test_. Resta solo in questa pagina e parte solo verso api.taplogic.it.