> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/features/cookies/integration/mobile/native.md).

# Applications natives

Cette page décrit l'API de gestion du consentement. Vous pouvez l'utiliser dans les applications mobiles natives.

Une application native n'affiche pas la bannière web : elle récupère la configuration de la bannière, affiche son propre écran de consentement, puis envoie les choix de l'utilisateur à Dastra. Les deux appels utilisent la clé d'API publique.

{% hint style="info" %}
Selon la région d'hébergement de votre organisation, l'adresse de l'API change (`api-bleu.dastra.eu` au lieu de `api.dastra.eu`). Utilisez celle de votre organisation.
{% endhint %}

Les requêtes sans en-tête `Origin`, comme celles d'une application native, sont acceptées sans contrôle des **Urls autorisées (CORS)**.

## Récupérer la configuration de la bannière

<mark style="color:blue;">`GET`</mark> `https://api.dastra.eu/v1/cookies/public/cookies-widget-settings/{id}?key={key}`

Cet endpoint renvoie la configuration complète de la bannière.

#### Paramètres de chemin

| Nom  | Type   | Description                 |
| ---- | ------ | --------------------------- |
| `id` | number | Identifiant de la bannière. |

#### Paramètres de requête

| Nom       | Type    | Description                                                                                                                                     |
| --------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `key`     | string  | La clé d'API publique.                                                                                                                          |
| `culture` | string  | La langue de la configuration (`en`, `fr`, etc.). À défaut, Dastra utilise l'en-tête `Accept-Language`, puis la première langue de la bannière. |
| `debug`   | boolean | Si la valeur est `true`, aucun évènement de visite n'est enregistré.                                                                            |

Exemple de réponse `200`. Les textes de la bannière et certains champs sont abrégés ; le contenu dépend de votre configuration.

```json
{
  "translation": {
    "id": "35dddc1a-3ceb-49a8-a8d2-fc343fdb56a3",
    "lang": "en",
    "startupTitle": "We use cookies",
    "startupDisclaimer": "Cookies let us personalize content and ads, provide social media features and analyze our traffic.",
    "buttonAcceptLabel": "Accept all",
    "buttonSettingsLabel": "Customize",
    "buttonLaterLabel": "Refuse all",
    "buttonConfirmLabel": "Save my choices",
    "innerTitle": "These are our services that use cookies",
    "categoryNecessaryLabel": "Strictly necessary",
    "categoryPreferenceLabel": "Preferences",
    "categoryAnalyticalLabel": "Analytics",
    "categoryMarketingLabel": "Marketing",
    "successMessage": "Your preferences have been saved."
  },
  "groups": [
    {
      "label": "Analytics",
      "excerpt": "Analytics cookies help us understand how visitors use the site.",
      "purpose": "Analytical",
      "services": [
        {
          "id": "e213aca4-79b7-4b93-2bad-08d897969898",
          "name": "Google Analytics",
          "slug": "google-analytics",
          "domain": "analytics.google.com",
          "logoUrl": "https://api.dastra.eu/v1/favicon/analytics.google.com",
          "privacyPolicyUrl": "https://policies.google.com/privacy",
          "defaultConsent": false,
          "requiredConsent": true,
          "purpose": "Analytical",
          "description": null,
          "cookies": [
            {
              "id": "de529978-3ae0-496d-bf25-daac9d7230c7",
              "serviceId": null,
              "name": "_ga",
              "description": null,
              "value": null,
              "thirdParty": false,
              "path": null,
              "domain": null,
              "expiryDays": 400
            }
          ],
          "lang": "en",
          "consentModeV2Permissions": []
        }
      ],
      "description": "Analytics cookies help us understand how visitors use the site.",
      "requiredConsent": true,
      "defaultConsent": false
    }
  ],
  "lang": "en",
  "availableLocales": ["en", "fr"],
  "id": 1,
  "versionKey": "36df80ee-235c-4485-b9e2-f28f5568f572",
  "lastVersionGeneration": "2026-10-12T14:28:55Z",
  "label": "Example banner",
  "enabled": true,
  "disableBanner": false,
  "saveConsentProof": true,
  "developerMode": false,
  "position": "BottomLeft",
  "timerTrigger": 0,
  "scrollTrigger": 0,
  "showFixedButton": true,
  "showCloseButton": true,
  "continueWithoutAcceptButton": false,
  "enableGlobalPrivacyControl": false,
  "hideCopyright": false,
  "buttonLayout": "Circle",
  "buttonLogoUrl": null,
  "autoGeneratedCookieNotice": false,
  "cookieNoticeUrl": "",
  "bgColor": "#FFFFFF",
  "colorTitle": "#0A153B",
  "colorBtn": "#687c77",
  "colorText": "#0A153B",
  "colorPrimary": "#EF4A2A",
  "colorSecondary": "#687c77",
  "customCSS": "",
  "fontFamily": "'Segoe UI', Tahoma, Geneva, Verdana, sans-serif",
  "consentStorageMode": "Cookies",
  "consentCookieName": null,
  "consentCookieDomain": null,
  "consentCookieExpiryTime": 180
}
```

La réponse correspond au modèle `CookieWidgetPublicDto`. Une réponse `400` indique une origine non autorisée, une bannière désactivée ou un abonnement expiré.

## Enregistrer les consentements

<mark style="color:green;">`POST`</mark> `https://api.dastra.eu/v1/cookies/public/collect/{id}?key={key}`

Cette méthode collecte les consentements aux cookies.

#### Paramètres de chemin

| Nom  | Type   | Description                 |
| ---- | ------ | --------------------------- |
| `id` | number | Identifiant de la bannière. |

#### Paramètres de requête

| Nom   | Type   | Description            |
| ----- | ------ | ---------------------- |
| `key` | string | La clé d'API publique. |

#### Corps de la requête

| Nom         | Type   | Description                                                                                                                                                                           |
| ----------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type`      | string | Le type d'évènement : `Visit`, `Quit` ou `Consents`.                                                                                                                                  |
| `consents`  | object | La liste des consentements de l'utilisateur (voir l'exemple ci-dessous).                                                                                                              |
| `consentId` | string | L'identifiant du consentement courant, s'il en existe déjà un.                                                                                                                        |
| `referrer`  | string | L'adresse de la page ou l'écran d'où provient l'évènement.                                                                                                                            |
| `userId`    | string | Identifiant pseudonyme de l'utilisateur dans vos systèmes (facultatif). Voir [Identification des utilisateurs](https://doc.dastra.eu/features/cookies/integration/identification.md). |

Exemple de corps :

```json
{
  "type": "Consents",
  "referrer": "my-app://settings/privacy",
  "userId": "{your_pseudonymous_user_id}",
  "consents": {
    "consentId": "6f47576e-5a0c-4219-8efe-331e72bab73a",
    "lang": "fr-FR",
    "versionKey": "36df80ee-235c-4485-b9e2-f28f5568f572",
    "cookieConsents": [
      {
        "id": "e213aca4-79b7-4b93-2bad-08d897969898",
        "name": "Google Analytics",
        "slug": "google-analytics",
        "consent": true,
        "date": "2026-10-12T14:00:04.133Z",
        "purpose": "Analytical"
      }
    ]
  }
}
```

La réponse `200` contient l'identifiant du consentement collecté, par exemple `140f213b-de17-4572-99a7-5075ccbcbbec`. Conservez-le dans l'application pour les appels suivants : c'est l'identifiant de la preuve de consentement. Les évènements envoyés par des robots sont ignorés, et la preuve n'est enregistrée que si l'option **Sauvegarde de la preuve de consentement** est active.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.dastra.eu/features/cookies/integration/mobile/native.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
