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

# API et webhooks

> Déclenchez des flux de travail à partir de systèmes externes via des API d'événements entrants.

## Vue d’ensemble

L’API de Stenoa permet à des systèmes externes de déclencher des workflows dans Stenoa via des API REST entrantes. Les hôpitaux, moteurs d’intégration et plateformes tierces peuvent envoyer des charges utiles d’événements structurées afin de lancer des consultations, mettre à jour des cas actifs ou acheminer des informations vers les équipes de garde, permettant ainsi la création d'intégrations reposant sur Stenoa.

Utilisez notre API lorsque vous souhaitez que Stenoa réagisse automatiquement à des actions système, telles qu'une nouvelle demande d’orientation, un résultat d’ECG, une mise à jour de mouvement patient ou une alerte de dispositif médical.

## URL de base

L’API Stenoa est basée sur les principes REST. Toutes les requêtes doivent obligatoirement être transmises via HTTPS, afin d’améliorer la sécurité, l’intégrité et la confidentialité des données. Les requêtes HTTP ne sont pas prises en charge.

Toutes les requêtes utilisent l’URL de base suivante :

```
https://api.stenoa.com
```

## Authentification

Pour vous authentifier, vous devez ajouter un en-tête *Authorization* dont la valeur est `Bearer re_xxxxxxxxx`, où `re_xxxxxxxxx` correspond à votre clé d’API.

```
Authorization: Bearer re_xxxxxxxxx
```

### Codes de réponse

Stenoa utilise les codes HTTP standard pour indiquer la réussite ou l’échec de vos requêtes.

En général, les codes HTTP 2xx indiquent une réussite, les codes 4xx correspondent à des erreurs liées au client, et les codes 5xx signalent des problèmes d’infrastructure.

| **Statut** | Description                                |
| ---------- | ------------------------------------------ |
| 200        | Requête réussie.                           |
| 400        | Vérifiez que les paramètres sont corrects. |
| 401        | La clé API utilisée n’a pas été fournie.   |
| 403        | La clé API utilisée n’est pas valide.      |
| 404        | La ressource est introuvable.              |
| 429        | La limite de débit a été dépassée.         |
| 5xx        | Erreur sur les serveurs de Stenoa.         |

### Limite de débit

Par défaut, la limite de débit maximale est fixée à 2 requêtes par seconde. Ce seuil peut être augmenté sur demande pour les émetteurs de confiance. Au-delà, vous atteindrez la limite de débit et recevrez un code d’erreur de réponse *429*.

Pour configurer vos sources d’événements via nos API entrantes, [contactez le support](mailto:support@stenoa.com).