Vai al contenuto
TapLogic API
English

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.

  1. 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"
  2. 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
    }
  3. Assegna un tag a una persona

    Prendi l'id di un membro da GET /members e passalo come member_id. L'intestazione Idempotency-Key rende 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"}'
  4. Ricevi i tocchi in tempo reale

    Registra un endpoint webhook per tag.scanned. La risposta contiene il segreto di firma whsec_…: 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
        }
      }
    }
  5. 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.