Riferimento API
Endpoint API pubblici per sviluppatori: moduli, Widget, configuratore prodotto e altro.
Questa documentazione descrive esclusivamente endpoint JSON reali e utilizzabili pubblicamente -- metodo, percorso, tipo di autenticazione, parametri obbligatori, richiesta e risposta di esempio, nonché i codici di errore documentati per ciascun endpoint. Zentor non dispone di un sistema generale di chiavi API per sviluppatori; a seconda della route, l'accesso avviene senza autenticazione oppure tramite un token di incorporamento del widget con verifica dell'origin. Le route interne della Dashboard e gli endpoint Master Admin sono deliberatamente esclusi da questa documentazione pubblica, poiché sono accessibili esclusivamente tramite una normale sessione autenticata.
Ogni voce endpoint contiene una nota sul test live che indica apertamente se l'informazione proviene dallo schema del Registry, da un test automatizzato o da un'osservazione live effettiva -- la sola somiglianza con un percorso di codice funzionante non è considerata una prova completa. Inoltre, una chiamata tecnicamente riuscita conferma sempre soltanto l'elaborazione della specifica richiesta, non automaticamente processi successivi come la consegna di un'e-mail, il completamento di un pagamento o un accesso SSO completato.
La protezione dipende dal gruppo interessato. Gli endpoint pubblici legali, di marketing e dei moduli non richiedono una sessione della Dashboard. Il widget utilizza invece l'header `X-Widget-Token` e una Origin-Allowlist. Gli accessi alla Dashboard forniscono un JWT di sessione con durata di dodici ore e un refresh token valido per sette giorni. Gli endpoint SSO utilizzano propri codici monouso e flussi di callback.
Leggi ogni pagina endpoint come un contratto autonomo. Sono determinanti il metodo HTTP, il percorso, i parametri obbligatori, i tipi di dati, il corpo della richiesta, la struttura della risposta, i codici di errore e l'idempotenza. Un esempio mostra un formato possibile, ma non sostituisce la verifica della risposta effettiva. Lo stato della configurazione, le validazioni, le autorizzazioni e i fornitori esterni possono modificare l'esito.
Il Rate Limit confermato a livello di piattaforma è di 2.000 richieste in 15 minuti. Limiti separati per singolo endpoint non sono documentati in modo uniforme. I client dovrebbero quindi evitare cicli di polling inutilmente ravvicinati. Per le operazioni non idempotenti, i tentativi automatici possono creare record o messaggi duplicati.
I valori sensibili non devono essere inseriti nei log. Tra questi rientrano password, reset token, codici di verifica, widget token, session ID e dati personali reali utilizzati negli esempi. Nella documentazione e nei test usa valori anonimizzati. Le note sui test live devono rappresentare correttamente le prove effettivamente disponibili.