Integrazione

Integrazione API

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:

  1. 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.
  1. Ambiente di produzione (Live)
    👉 https://dld.datalegaldrive.com/