> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentification

> Authentifiez vos requêtes à l'API Pubrio à l'aide de l'en-tête `pubrio-api-key` — configuration, gestion des clés et bonnes pratiques de sécurité.

## Clé API

Pour vous authentifier, l'en-tête `pubrio-api-key` doit être inclus. Cet en-tête doit contenir la clé API, par exemple `a1b2c3d4e5f6g7h8`, qui représente votre clé API.

```
pubrio-api-key: a1b2c3d4e5f6g7h8
```

Vous devez créer une clé API pour accéder à l'API Pubrio. Pour créer une clé API, rendez-vous dans la section [Paramètres](https://dashboard.pubrio.com/#/settings/).

<Note>
  La clé API contient déjà les informations de votre espace de travail (profil) ; vous n'avez donc pas besoin de transmettre `profile_id` dans le corps de votre requête. Le paramètre `profile_id` reste accepté pour des raisons de rétrocompatibilité, mais n'est plus obligatoire.
</Note>

## En-têtes de requête

En plus de `pubrio-api-key`, envoyez un en-tête `User-Agent` identifiant votre client.

```
pubrio-api-key: a1b2c3d4e5f6g7h8
Content-Type: application/json
User-Agent: my-app/1.0
```

<Warning>
  **Un `User-Agent` manquant ou générique est rejeté avant même d'atteindre l'API.** Les requêtes sans user agent reconnu sont bloquées en périphérie et renvoient un `HTTP 403` avec le corps en texte brut `error code: 1010` — pas du JSON, et ce code ne figure pas parmi les [codes d'erreur documentés](/fr/api-reference/status-codes). Cela ressemble à un échec d'authentification, mais ce n'en est pas un : votre clé API est valide.

  Les user agents par défaut de nombreuses bibliothèques HTTP courantes sont concernés — celui de `urllib` en Python (`Python-urllib/3.x`) est bloqué, alors que `curl` et `requests` ne le sont pas. Si vous obtenez `error code: 1010`, définissez un `User-Agent` explicite et réessayez.
</Warning>