Native applications

This page details how the consent management API works. This API can be easily integrated in native mobile applications.

Retrieve the widget configuration

GET https://api.dastra.eu/v1/client/cookie-widget-settings/:id?key=:key

This endpoint allows you to retrieve the entire configuration of the widget

Path Parameters

Name	Type	Description
id	number	ID of the widget configuration

Query Parameters

Name	Type	Description
culture	string	The locale of the widget configuration (en, fr...)
key	string	The public api key provided

200 Cake successfully retrieved.

{
  "translation": {
    "id": "35dddc1a-3ceb-49a8-a8d2-fc343fdb56a3",
    "lang": "fr",
    "order": 0,
    "buttonBackLabel": "Retour",
    "buttonAcceptLabel": "Accepter tout",
    "buttonSettingsLabel": "Personnaliser",
    "buttonViewPurposeLabel": "Sélectionner les finalités",
    "buttonConfirmLabel": "Enregistrer sélection",
    "buttonAcceptAllLabel": "Tout accepter",
    "buttonLaterLabel": "Tout refuser",
    "buttonViewMoreLabel": "Voir la liste",
    "noticeUrlButtonLabel": "Lire notre politique des cookies",
    "startupTitle": "Nous utilisons les cookies",
    "startupDisclaimer": "Les cookies nous permettent de personnaliser le contenu et les annonces, d'offrir des fonctionnalités relatives aux médias sociaux et d'analyser notre trafic. Nous partageons également des informations sur l'utilisation de notre site avec nos partenaires de médias sociaux, de publicité et d'analyse, qui peuvent combiner celles-ci avec d'autres informations que vous leur avez fournies ou qu'ils ont collectées lors de votre utilisation de leurs services",
    "innerTitle": "Voici nos services qui utilisent les cookies",
    "innerDisclaimer": "Dans cet écran de configuration, vous pouvez choisir les cookies que vous autorisez lors de votre navigation",
    "categoryNecessaryLabel": "Cookies nécessaires",
    "categoryNecessaryExcerpt": "Les cookies nécessaires contribuent à rendre un site Web utilisable en activant des fonctions de base comme la navigation de page et l'accès aux zones sécurisées du site Web. Le site Web ne peut pas fonctionner correctement sans ces cookies.",
    "categoryNecessaryDescription": "Les cookies nécessaires contribuent à rendre un site Web utilisable en activant des fonctions de base comme la navigation de page et l'accès aux zones sécurisées du site Web. Le site Web ne peut pas fonctionner correctement sans ces cookies.",
    "categoryPreferenceLabel": "Préférences",
    "categoryPreferenceExcerpt": "Les cookies de préférences permettent à un site Web de retenir des informations qui modifient la manière dont le site se comporte ou s’affiche, comme votre langue préférée ou la région dans laquelle vous vous situez.",
    "categoryPreferenceDescription": "Les cookies de préférences permettent à un site Web de retenir des informations qui modifient la manière dont le site se comporte ou s’affiche, comme votre langue préférée ou la région dans laquelle vous vous situez.",
    "categoryAnalyticalLabel": "Statistiques",
    "categoryAnalyticalExcerpt": "Les cookies statistiques aident les propriétaires du site Web, par la collecte et la communication d'informations de manière anonyme, à comprendre comment les visiteurs interagissent avec les sites Web.",
    "categoryAnalyticalDescription": "Les cookies statistiques aident les propriétaires du site Web, par la collecte et la communication d'informations de manière anonyme, à comprendre comment les visiteurs interagissent avec les sites Web.",
    "categoryMarketingLabel": "Marketing",
    "categoryMarketingExcerpt": "Les cookies marketing sont utilisés pour effectuer le suivi des visiteurs au travers des sites Web. Le but est d'afficher des publicités qui sont pertinentes et intéressantes pour l'utilisateur individuel et donc plus précieuses pour les éditeurs et annonceurs tiers.",
    "categoryMarketingDescription": "Les cookies marketing sont utilisés pour effectuer le suivi des visiteurs au travers des sites Web. Le but est d'afficher des publicités qui sont pertinentes et intéressantes pour l'utilisateur individuel et donc plus précieuses pour les éditeurs et annonceurs tiers.",
    "categoryOtherLabel": "Autres cookies",
    "categoryOtherExcerpt": "Ecrire une description courte ici",
    "categoryOtherDescription": "Ecrire une description longue ici",
    "categoryIABLabel": "Services publicitaires de l'IAB",
    "categoryIABExcerpt": "Ces services utilisent les cookies principalement à des fin d'amélioration de la qualité des messages publicitaires.",
    "categoryIABDescription": "Ces services utilisent les cookies principalement à des fin d'amélioration de la qualité des messages publicitaires.",
    "cookieDeclaration": null,
    "buttonYes": "Oui",
    "buttonNo": "Non",
    "viewProof": "Afficher la preuve du consentement",
    "successMessage": "Vos préférences ont été sauvegardées ! Merci ! "
  },
  "groups": [
    {
      "label": "Marketing",
      "excerpt": "Les cookies marketing sont utilisés pour effectuer le suivi des visiteurs au travers des sites Web. Le but est d'afficher des publicités qui sont pertinentes et intéressantes pour l'utilisateur individuel et donc plus précieuses pour les éditeurs et annonceurs tiers.",
      "purpose": 3,
      "services": [
        {
          "id": "e213aca4-79b7-4b93-2bad-08d897969898",
          "name": "yrdy",
          "slug": "yrdy",
          "domain": "www.dastra.eu",
          "logoUrl": "https://api.dastra.eu/v1/favicon/www.dastra.eu",
          "privacyPolicyUrl": null,
          "defaultConsent": false,
          "requiredConsent": true,
          "purpose": 3,
          "description": null,
          "cookies": [
            {
              "id": "de529978-3ae0-496d-bf25-daac9d7230c7",
              "serviceId": null,
              "name": "yrdy",
              "description": null,
              "value": null,
              "path": null,
              "domain": null,
              "expiryDays": null
            }
          ],
          "lang": "fr"
        }
      ],
      "description": "Les cookies marketing sont utilisés pour effectuer le suivi des visiteurs au travers des sites Web. Le but est d'afficher des publicités qui sont pertinentes et intéressantes pour l'utilisateur individuel et donc plus précieuses pour les éditeurs et annonceurs tiers.",
      "requiredConsent": true,
      "defaultConsent": false
    }
  ],
  "lang": "fr",
  "versionKey": "36df80ee-235c-4485-b9e2-f28f5568f572",
  "lastVersionGeneration": "2020-12-03T14:28:55.5450603",
  "buttonLogoUrl": null,
  "enabled": true,
  "label": "www.dastra.eu",
  "displayLogo": true,
  "hideCopyright": false,
  "showFixedButton": true,
  "developerMode": true,
  "saveConsentProof": true,
  "isValid": false,
  "position": "BottomLeft",
  "timerTrigger": 0,
  "scrollTrigger": 0,
  "autoGeneratedCookieNotice": false,
  "cookieNoticeUrl": "",
  "bgColor": "#FFFFFF",
  "colorTitle": "#2E4058",
  "colorBtn": "#686868",
  "colorText": "#2E4058",
  "colorPrimary": "#E7630A",
  "colorSecondary": "#48ba61",
  "customCSS": "",
  "enableIAB": false,
  "tcfVersion": 1,
  "fontFamily": "'Segoe UI', Tahoma, Geneva, Verdana, sans-serif",
  "dateCreation": "2020-12-03T14:20:19.3703522",
  "dateUpdate": "2021-03-15T12:32:09.848664",
  "consentCookieExpiryTime": 180,
  "consentCookieName": null,
  "id": 1,
  "tenant": null,
  "tenantId": 1
}

Registration of consents

POST https://api.dastra.eu/v1/client/collect/:id?key=:key

This method allows to collect the consents to cookies

Path Parameters

Name	Type	Description
id	string	ID of the widget configuration

Query Parameters

Name	Type	Description
key	string	The public api key

Request Body

Name	Type	Description
consents	object	The list of user's consents { "cookieConsents": [ { "consent":true, // True if consented, false if refused "id":"e213aca4-79b7-4b93-2bad-08d897969898", // Cookies id "date":"2021-03-15T14:00:04.133Z", "name":"yrdy", "slug":"yrdy", "purpose":3 } ], "lang":"fr-FR", "consentId":"6f47576e-5a0c-4219-8efe-331e72bab73a", "date":1615809009744 }
type	string	CookieEventType Visit,Quit,Consents
consentId	string	The current consent Id (If any collected before)
userId	string	Custom user id (

200 Return the id of the consent collected

140f213b-de17-4572-99a7-5075ccbcbbec