Il software GDPR espone un insieme di API che consentono un'integrazione dettagliata con le applicazioni client. Questo articolo è rivolto a sviluppatori e/o responsabili di progetto e descrive la procedura di integrazione e i prerequisiti necessari.
Passaggi
- Ottenere le chiavi API
- Integrare nell'ambiente Sandbox
- Passare alla produzione (Go Live)
- Documentazione OpenAPI
Le API sono esposte in formato JSON/REST. I contratti di interfaccia e gli schemi dei dati sono documentati nel formato OpenAPI 3.0 e sono disponibili al seguente indirizzo:
👉 https://dld-sandbox.datalegaldrive.com/api/v1/api-docs
Questo documento tecnico è protetto. È necessario accedere prima al software GDPR all'indirizzo https://dld-sandbox.datalegaldrive.com/#/login per poterlo consultare.
Questi contratti di interfaccia possono essere utilizzati per generare modelli di query/risposta in qualsiasi programma che supporti OpenAPI (ad esempio: https://redocly.github.io/redoc/).
Sicurezza delle API
Le API sono protette tramite un sistema di chiavi API. Una chiave è composta da un AccessKey e da una SecretKey.
Per ottenere il proprio set di chiavi, si prega di contattare il Supporto DLD.
Ogni chiave API è associata a una specifica entità e consente di operare esclusivamente nell'ambito di tale entità.
Le informazioni di autenticazione vengono fornite inviando un'intestazione HTTP nel seguente formato:
1 x-api-key: accessKey={ACCESS_KEY};secretKey={SECRET_KEY}
Le chiavi sono specifiche per ogni ambiente.
Revoca delle chiavi
In caso di compromissione delle chiavi API, si prega di informare immediatamente il Supporto Privacy Cockpit affinché le chiavi possano essere revocate e nuove chiavi generate.
Ambienti
Sono disponibili due ambienti:
- Ambiente di integrazione per test e implementazioni:
👉 https://dld-sandbox.datalegaldrive.com/
- I dati in questo ambiente non vengono salvati né replicati.
- I database possono essere inizializzati in qualsiasi momento dal team tecnico di Privacy Cockpit.
- Ambiente di produzione (Live)
👉 https://dld.datalegaldrive.com/