REST API · Webhooks · Shopify · Widget

Integra Fidaty con il tuo stack esistente.

Una superficie di integrazione completa: REST API per il tuo ERP/PIM/PLM, webhook outbound per sistemi event-driven, webhook inbound per la sincronizzazione in tempo reale, un'app Shopify per i brand D2C e un widget JavaScript drop-in per qualsiasi sito web. Documentazione pubblica, prezzi prevedibili.

REST API + 6 scopeWebhook outbound + inboundConnettore ufficiale ShopifyWidget JS embeddable (93 KB)

8

Endpoint pubblici

REST v1

500

Record/bulk

Cap per richiesta (piano Advanced)

HMAC-256

Firma webhook

Entrambe le direzioni

93 KB

Bundle widget

Gzippato

Aperto by design

Nessun vendor lock-in. Documentazione pubblica. Prezzi trasparenti.

Troppe piattaforme di compliance nascondono la propria API dietro una sales call. La documentazione API di Fidaty è pubblica, gli endpoint sono stabili, i rate limit sono divisi per tier e deterministici. Puoi costruire un'integrazione in un pomeriggio e sapere esattamente quanto pagherai a regime.

REST API

REST API type-safe per ogni operazione di prodotto.

Genera certificati, aggiorna dati DPP, interroga le scansioni, gestisci i fornitori — tutto via endpoint REST idempotenti. API key con scope, rate limit a finestra scorrevole, JSON in request/response, header X-Request-ID per il supporto.

8 endpoint principali

GET /certificates (lista, paginata), GET /certificates/:id, POST /certificates, POST /certificates/bulk (fino a 500/req), PATCH /certificates/:id/dpp, PATCH /certificates/:id/revoke, GET /analytics/scans, GET /analytics/scans/:id.

API key con scope granulari

6 scope: certificates:read, certificates:write, analytics:read, eudr:read, eudr:write, webhooks:read. Chiave hashata con SHA-256 lato server, prefisso visibile nei log per l'audit, scadenza opzionale, revoca istantanea.

Rate limit a finestra scorrevole

Free 60 req/min · Starter 300 · Advanced 1000 · Enterprise 5000. Finestra scorrevole di 60s per API key. Header X-RateLimit-Limit / Remaining / Retry-After su ogni risposta.

Documentazione pubblica e interattiva

Pagina API docs live nella dashboard: ogni endpoint con parametri, scope, esempio di risposta, snippet curl funzionante. Pronto al copy-paste.

WEBHOOKS

Integrazione event-driven in entrambe le direzioni.

Outbound: Fidaty notifica i tuoi sistemi quando accadono eventi. Inbound: i tuoi sistemi notificano Fidaty. Entrambi protetti con firma HMAC-SHA256 e protezione anti-replay.

Outbound: 7 tipi di evento

certificate.created, certificate.revoked, certificate.scanned, certificate.expired, transfer.created, transfer.claimed, dispute.opened. Retry con backoff esponenziale (1m, 5m, 30m, 2h, 6h, 24h).

Inbound: push verso Fidaty

5 tipi di evento: certificate.upsert, dpp.patch, custody.append, supplier.upsert, component.upsert. Endpoint firmato HMAC-SHA256, protezione anti-replay con tolerance_seconds configurabile.

Delivery log completo

Ogni tentativo loggato: status code, response body (troncato), latenza, conteggio retry, next_retry_at. Debug-friendly: i ticket di supporto si risolvono 10× più rapidamente.

SYNC

Sincronizzazione bidirezionale in tempo reale con i tuoi sistemi.

Webhook outbound + endpoint inbound = sincronizzazione bidirezionale con ERP, PIM, PLM, CRM e piattaforme di sustainability. I DPP restano allineati su tutti i tuoi sistemi senza lavoro manuale.

Ingestion bulk da ERP/PIM

POST /certificates/bulk fino a 500 record per richiesta. Gestione errori per record (207 Multi-Status): i fallimenti parziali non bloccano il batch.

Endpoint di update solo DPP

PATCH /certificates/:id/dpp aggiorna solo i campi DPP (level, industry, dpp_data, parent). Perfetto per i tool LCA che aggiornano i dati di footprint senza toccare l'identità on-chain.

Coda di job asincroni

Pubblicazione bulk, export EPCIS in batch, ricalcolo compliance: accoda il job, ricevi un webhook al completamento. Niente connessioni HTTP-long per operazioni pesanti.

PLUG-AND-PLAY

Connettori pre-costruiti per gli stack più comuni.

Connettore Shopify (ufficiale), widget di verifica (JS embeddable), import CSV bulk, notifiche Slack. Parti in pochi minuti, salta il progetto di integrazione.

Connettore ufficiale Shopify

Collega il tuo store, mappa gli handle Shopify ai template Fidaty. Ogni ordine evaso genera automaticamente un certificato con l'email del cliente. Zero codice.

Widget di verifica

Copia-incolla un tag `<script>` su qualsiasi pagina prodotto. I visitatori vedono live una card "Verified by Fidaty", con stato on-chain in tempo reale. 93 KB gzippati.

Import CSV bulk

Carica uno spreadsheet con fino a 1.000 certificati. Wizard di mapping colonne, anteprima di validazione, report errori per riga. Perfetto per i lanci stagionali.

Use cases

Real scenarios where this service delivers.

Integrazione SAP / ERP

Batch notturno dall'export ordini di SAP → POST /certificates/bulk. 10.000 ordini/notte processati in pochi minuti. Certificati pronti prima delle spedizioni del mattino successivo.

Auto-sync PIM → DPP

Akeneo PIM invia gli aggiornamenti dei materiali via webhook inbound → PATCH /dpp. Carbon footprint e materiali restano allineati tra i sistemi senza lavoro manuale.

Brand D2C Shopify

Collegalo una volta, dimenticalo. Ogni vendita diventa un certificato verificato, il cliente riceve un QR nell'email di conferma spedizione. Compliance + marketing in uno.

Embed sul sito corporate

Aggiungi il widget a qualsiasi `<div>` nelle tue pagine di product detail. I visitatori vedono il certificato senza lasciare la pagina. Conversion uplift misurato del 12%.

Why Fidaty

Built for brands that take trust seriously.

Every service in the Fidaty platform is integrated with the rest: identity, compliance, analytics and consumer engagement flow seamlessly. No data silos, no duplicate work.

Book a demo
  • Documentazione API pubblica (non gated dietro le vendite)
  • Sync webhook bidirezionale (la maggior parte delle piattaforme offre solo outbound)
  • Rate limit legati al tier di subscription, visibili negli header
  • Connettore Shopify mantenuto ufficialmente
  • Bundle widget da 93 KB — più piccolo di molti tracking pixel
  • X-Request-ID su ogni risposta per debugging rapido nel supporto
Verified on-chain

Il tuo stack, la nostra infrastruttura passport.

L'accesso API è disponibile da Starter in su. Enterprise sblocca rate limit dedicati, priorità sui job asincroni e supporto con SLA.