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

# Introduction

> Comprendre les concepts généraux, les codes de réponse et les stratégies d'authentification.

<Note>
  Si vous n'avez pas encore de compte, veuillez créer un compte maintenant
  [Créer un compte](https://app.notiline.net).
</Note>

## URL de base

L'API Notiline repose sur les principes <strong>REST</strong>.
Nous appliquons le protocole <strong>HTTPS</strong> à chaque demande afin d'améliorer la sécurité, l'intégrité et la confidentialité des données.
L'API ne prend pas en charge le protocole HTTP.

```bash theme={null}
https://api.notiline.net/api/v1
```

## Authentification

Pour vous authentifier, vous devez ajouter un en-tête Authorization dont le contenu est `Bearer n_123456789` où `re_123456789` est votre clé API.

```bash theme={null}
Authorization: Bearer n_123456789
```

## Codes HTTPS

Notiline utilise les codes HTTP standard pour indiquer le succès ou l'échec de vos demandes.
En général, les codes HTTP `2xx` correspondent à des succès, les codes `4xx` à des échecs liés à l'utilisateur et les codes `5xx` à des problèmes d'infrastructure.

| Statut | Description                                    |
| ------ | ---------------------------------------------- |
| `200`  | Demande acceptée                               |
| `400`  | Vérifier que les paramètres sont corrects.     |
| `401`  | La clé API utilisée était manquante.           |
| `403`  | La clé API utilisée n'est pas valide.          |
| `404`  | La ressource n'a pas été trouvée.              |
| `429`  | La limite de débit a été dépassée.             |
| `500`  | Indique une erreur avec les serveurs Notiline. |

<Note>
  Consultez les [codes d'erreur](/api-reference/errors) pour obtenir une liste complète de toutes les erreurs possibles de l'API.
</Note>

## Limites

Les en-têtes de réponse décrivent votre limite de débit actuelle après chaque demande, conformément à [la norme IETF](https://datatracker.ietf.org/doc/html/draft-ietf-httpapi-ratelimit-headers) :

| Nom de l'en-tête      | Description                                                           |
| --------------------- | --------------------------------------------------------------------- |
| `ratelimit-limit`     | Nombre maximum de demandes autorisées dans une fenêtre.               |
| `ratelimit-remaining` | Nombre de demandes restantes dans la fenêtre actuelle.                |
| `ratelimit-reset`     | Nombre de secondes avant la réinitialisation des limites.             |
| `retry-after`         | Nombre de secondes à attendre avant d'effectuer une demande de suivi. |

La limite maximale par défaut est de `2 demandes par seconde`. Ce nombre peut être augmenté sur demande pour les expéditeurs de confiance.

Après cela, vous atteindrez la limite de débit et recevrez un code d'erreur de réponse `429`.

Pour éviter cela, nous vous recommandons de réduire la vitesse à laquelle vous demandez l'API. Pour ce faire, vous pouvez introduire un mécanisme de file d'attente ou réduire le nombre de demandes simultanées par seconde.
Si vous avez des besoins spécifiques, [contactez le support](https://notiline.net/contact) pour obtenir de l'aide.

## FAQ

<Accordion title="À combien de contact je peux envoyer un message ?">
  Vous pouvez envoyer un message à 10 000 contacts à la fois
</Accordion>