Passer au contenu principal

​
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és pour lancer des consultations, mettre à jour des cas actifs ou acheminer des informations vers les équipes en astreinte, ce qui vous permet de créer des intégrations s’appuyant sur Stenoa. Utilisez notre API lorsque vous avez besoin que Stenoa réagisse automatiquement à des actions système — comme 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. Nous imposons l’utilisation de HTTPS pour toutes les requêtes afin d’améliorer la sécurité, l’intégrité et la confidentialité des données. L’API ne prend pas en charge HTTP. 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.
StatutDescription
200Requête réussie.
400Vérifiez que les paramètres sont corrects.
401La clé API utilisée n’a pas été fournie.
403La clé API utilisée n’est pas valide.
404La ressource est introuvable.
429La limite de débit a été dépassée.
5xxErreur 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.