Links

Intégration de l'API

Cette page vous explique comment manipuler directement vos demandes d'exercice de droits dans Dastra sans intégrer le SDK javascript grâce à notre API Rest.
Dastra ne s'intégrant pas nativement à toutes les plateformes de développement, nous mettons à votre disposition une API Rest pour gérer vos demandes d'exercice de droits depuis vos applications.

Le JSON de l'objet demande d'exercice de droits

Vous trouverez ci-dessous le modèle objet au format JSON d'une demande d'exercice de droits dans Dastra.
L'objet demande d'exercice de droits
{
"customFields": {
"13_long": "1234567891234",
"13_html": "1234567891234"
},
"closedByUser": null,
"area": {
"order": XXX,
"children": [],
"permissions": [],
"id": XXX,
"type": "Entity",
"parentId": null,
"ref": null,
"label": "Moulinsart",
"description": null,
"logoUrl": null,
"address": null,
"zipCode": null,
"city": null,
"countryCode": "BE",
"immatriculationNumber": null,
"phoneNumber": null,
"mailAddress": null,
"dpo": null,
"referent": null,
"representative": null,
"dataProtectionAuthority": null
},
"creator": null,
"operator": null,
"operatorId": null,
"attachments": [],
"messages": [],
"tags": [],
"id": XXX,
"title": "",
"locale": "fr",
"archived": false,
"archivedDate": null,
"subjectCategoryId": null,
"subjectCategory": null,
"complex": false,
"dateClosed": null,
"areaId": XX,
"state": "Open",
"description": null,
"message": null,
"resolutionMessage": null,
"email": "",
"phoneNumber": null,
"givenName": "",
"familyName": null,
"dateDemand": "2023-09-18T10:31:30.6882299",
"dateCreation": "2023-09-18T10:31:30.6882299",
"dateUpdate": null,
"workFlowStep": {
"id": 22290,
"label": "Nouveau",
"color": "#1E8EE1",
"order": 0,
"itemLimit": null,
"type": "DataSubjectRequest",
"finalStep": false,
"initialStep": true,
"authorizedRole": null,
"authorizedRoleId": null,
"descriptionHtml": null,
"mappedState": "Open"
},
"workFlowStepId": XX,
"channel": "Widget",
"refId": null,
"userId": null,
"purposes": [
"Rectification"
],
"closedReason": "None",
"closedReasonDescription": null,
"expiryTime": "2023-10-18T10:31:30.68823",
"address": null,
"zipCode": null,
"city": null,
"countryCode": null,
"nbMessages": 0,
"nbMessagesNotViewed": 0,
"nbMessagesIncoming": 0,
"lastMessageDate": null,
"remainingDays": -6,
"closingTime": null,
"additionalDatas": {
"givenName": null,
"13_long": "XX",
"13_html": "XX"
},
"userNotified": false,
"dateUserNotified": null,
"sendNotification": false,
"emailValidationDate": "2023-09-18T10:31:53.8554799",
"mailValidated": true,
"referrerUrl": "",
"demandId": "",
"identityValidated": false,
"dateIdentityValidated": null,
"widgetId": 0
}
]
Pour récupérer le format Objet de votre configurée avec des champs personnalisés, vous pouvez faire un export d'une demande au format JSON et obtenir ainsi le modèle JSON.

Les EndPoints de l'API

Voici les principaux Endpoints qui vous seront utiles pour intégrer vos applications avec le module exercice de droits de Dastra.
post
/v1​/ws​/
{workspaceId}​/DataSubjectRequests
Créer une nouvelle demande d'exercice de droits dans Dastra
get
​/v1​/ws​/
{workspaceId}​/DataSubjectRequests​/{id}
Récupérer une demande d'exercice de droits existante via son id
get
​/v1​/ws​/
{workspaceId}​/DataSubjectRequests
Récupérer une liste paginée de demandes d'exercice de droits
put
/v1/ws/
{workspaceId}​/DataSubjectRequests​/{id}
Mettre à jour une demande d'exercice de droits
delete
​/v1​/ws​/
{workspaceId}​/DataSubjectRequests​/{id}
Supprimer une demande d'exercice de droits via son id
post
/v1​/ws​/
{workspaceId}​/DataSubjectRequests​/workflow
Changer l'étape de processus de la demande d'exercice de droits
post
/v1​/ws​/
{workspaceId}​/DataSubjectRequests​/archive​/{id}
Archiver une demande d'exercice de droit via son Id
post
​/v1​/ws​/
{workspaceId}​/DataSubjectRequests​/restore​/{id}
Retirer le statut archiver d'une demande d'exercice de droits