# Native applications

## Retrieve the widget configuration

<mark style="color:blue;">`GET`</mark> `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                        |

{% tabs %}
{% tab title="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
}
```

{% endtab %}
{% endtabs %}

## Registration of consents

<mark style="color:green;">`POST`</mark> `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 | <p>The list of user's consents<br><br><code>{</code><br><code>"cookieConsents":</code><br><code>\[</code><br><code>{</code><br><code>"consent":true, // True if consented, false if refused</code><br><code>"id":"e213aca4-79b7-4b93-2bad-08d897969898", // Cookies id</code><br><code>"date":"2021-03-15T14:00:04.133Z",</code><br><code>"name":"yrdy",</code><br><code>"slug":"yrdy",</code><br><code>"purpose":3</code><br><code>}</code><br><code>],</code><br><code>"lang":"fr-FR",</code><br><code>"consentId":"6f47576e-5a0c-4219-8efe-331e72bab73a",</code><br><code>"date":1615809009744</code><br><code>}</code><br><br><br><br><br><br><br><br><br><br></p> |
| type      | string | CookieEventType Visit,Quit,Consents                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| consentId | string | The current consent Id (If any collected before)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| userId    | string | Custom user id (                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

{% tabs %}
{% tab title="200 Return the id of the consent collected" %}

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

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.dastra.eu/en/features/gerer-le-consentement-aux-cookies/integration-technique/mobile-applications/native-applications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.