Skip to main content

Integrazione

Una app per potersi integrare con il sistema di data retention deve mettere a disposizione del servizio data-retention-hub le seguenti API:

  • una POST per lanciare il job di archiviazione dati, che ritorna un 202
  • una POST per lanciare il job di cancellazione dati, che ritorna un 202
  • una POST per lanciare il job di rollback (es. il cliente riacquista la licenza), che ritorna un 202

Le API devono essere asincrone, in modo tale che data-retention-hub non rimanga appeso

L'autenticazione davanti a queste API è a carico dell’applicazione che si vuole integrare,  deve essere predisposto un token per poter richiamare le API da parte di data-retention-hub. In caso di una app che usa il sistema di autenticazione di TS Digital, va benissimo un token generato da TSDigital.

La struttura degli header e body delle request dovrà essere identica per tutte 3 le API.

Esempio di cURL

curl --location --request POST 'http://localhost:8080/api/archive' \ 
--header 'Content-Type: application/json' \
--header 'X-App-Name: POSTMAN' \
--header 'X-App-Version: 1.0.0' \
--header 'X-Correlation-Id: e97120a7-b65e-4dac-85e7-311b0aa1b5fc' \
--header 'X-Request-Id: 008f7273-8f01-48f7-b9fc-95422de6d77f' \
--header 'Authorization: Bearer <TOKEN>' \
--data-raw '{"jobData":{"itemId": "efd87ca0-b442-4d8a-8fa9-16afaea05a04"}}'

No comments to display

Back to top