---
title: "Authentification"
description: "Créer une clé d’API et l’utiliser dans vos requêtes."
---

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

# Authentification

## Créer une clé d’API

Il faut être administrateur de l’entreprise, avec l’accès **Lecture & Edition**. Dans Puncto,
ouvrez **Intégrations › API** :

1. Cliquez sur **Créer une clé**, nommez-la d’après l’outil qui l’utilisera et choisissez son
   accès : **Lecture Seule** ou **Lecture & Edition**.
2. Copiez la clé affichée, car elle ne sera plus visible ensuite.

- La clé donne accès aux données de toute l’entreprise, dans la limite de l’accès choisi.
- Gardez-la côté serveur, jamais dans une application web ou mobile.
- Créez une clé par outil. Vous pouvez révoquer chaque clé depuis la même page sans affecter les
  autres. Les requêtes qui utilisent une clé révoquée échouent immédiatement.

## Envoyer la clé

Passez la clé dans l’en-tête `Authorization` de chaque requête :

```bash
curl https://api.puncto.fr/public/v1/collaborators \
  -H "Authorization: Bearer $PUNCTO_TOKEN"
```

## Environnements

| Environnement | URL de base |
| --- | --- |
| Production | `https://api.puncto.fr` |
| Staging | `https://staging.api.puncto.fr` |

Chaque environnement a ses propres clés. Validez votre intégration en staging avant de passer en
production.

## Erreurs

| Statut | Cause |
| --- | --- |
| `401` | Clé absente, invalide ou révoquée |
| `403` | Opération hors de l’accès de la clé, par exemple une écriture avec une clé en lecture seule |

Source: https://docs.puncto.fr/developpeurs/authentification/index.mdx
