Primi passi in 5 minuti
Crei una chiave di test, leggi i tuoi tag, ne assegni uno e ricevi il primo tocco sul tuo server.
Crea una chiave di test
Nell'app TapLogic apri Impostazioni → API e webhook → Chiavi API e premi «Nuova chiave». Scegli la modalità Test e gli ambiti
tags:read,tags:write,scans:read,webhooks:write. La chiave compare una sola volta: copiala e salvala in una variabile d'ambiente.export TAPLOGIC_API_KEY="tl_test_4eC39HqLyjWDarjtT1zdp7dc"Leggi i tuoi tag
Con una chiave di test vedi solo i tag demo: puoi provare tutto senza toccare i tag veri dei clienti.
curl "https://api.taplogic.it/v1/tags?limit=10" \ -H "Authorization: Bearer $TAPLOGIC_API_KEY"{ "object": "list", "data": [ { "id": "cm3tag0001", "object": "tag", "code": "K7P2QX9M", "url": "https://t.taplogic.it/K7P2QX9M", "email_address": "k7p2qx9m@m.taplogic.it", "chip_type": "ntag213", "status": "assigned", "product": { "id": "cm3prd0001", "type": "keychain", "name": "Portachiavi" }, "member_id": null, "action_id": null, "location": null, "livemode": false, "created_at": "2026-11-18T09:12:00.000Z", "updated_at": "2026-11-18T09:12:00.000Z" } ], "has_more": false, "next_cursor": null }Assegna un tag a una persona
Prendi l'
iddi un membro daGET /memberse passalo comemember_id. L'intestazioneIdempotency-Keyrende sicuro ripetere la richiesta se la rete cade.curl -X PATCH "https://api.taplogic.it/v1/tags/cm3tag0001" \ -H "Authorization: Bearer $TAPLOGIC_API_KEY" \ -H "Idempotency-Key: assegna-K7P2QX9M-1" \ -H "Content-Type: application/json" \ -d '{"member_id":"cm3mbr0001"}'Ricevi i tocchi in tempo reale
Registra un endpoint webhook per
tag.scanned. La risposta contiene il segreto di firmawhsec_…: usalo per verificare ogni evento (vedi Webhook). Poi invia un evento di prova.curl -X POST "https://api.taplogic.it/v1/webhooks" \ -H "Authorization: Bearer $TAPLOGIC_API_KEY" \ -H "Idempotency-Key: endpoint-principale" \ -H "Content-Type: application/json" \ -d '{"url":"https://esempio.it/webhook/taplogic","enabled_events":["tag.scanned"]}'curl -X POST "https://api.taplogic.it/v1/webhooks/cm3whk0001/test" \ -H "Authorization: Bearer $TAPLOGIC_API_KEY"{ "id": "evt_9f3Kd2LmQx81ZpRt0aBcYvWs", "object": "event", "type": "tag.scanned", "api_version": "2026-11-18", "created": 1763457600, "livemode": false, "data": { "object": { "id": "cm3scn0001", "object": "scan", "tag_id": "cm3tag0001", "code": "K7P2QX9M", "occurred_at": "2026-11-18T09:20:00.000Z", "outcome": "ok", "action_type": "whatsapp", "destination": "https://wa.me/390212345678", "location_source": "network", "member_id": "cm3mbr0001", "product_id": "cm3prd0001", "country": "IT", "city": "Milano", "livemode": false } } }Leggi lo storico dei tocchi
Filtra per periodo, tag o membro. Gli orari sono in UTC, formato ISO 8601.
curl "https://api.taplogic.it/v1/scans?from=2026-11-01T00:00:00Z&tag=cm3tag0001" \ -H "Authorization: Bearer $TAPLOGIC_API_KEY"
Fatto. Quando sei pronto, crea una chiave Live con gli stessi ambiti: il codice non cambia. Continua con Errori e Paginazione.