Intégration

Intégrez Medicapp à vos parcours existants

Le parcours, l'étape, le dossier, le score et l'alerte sont des objets du produit, pas des vues d'écran. Ils s'exposent tels quels par l'API partenaire : ce que reçoit votre application est ce que manipule Medicapp Pro.

Obtenir une clé de test Lire la documentation

Clé délivrée immédiatement, sans passer par un commercial. Environnement de test préchargé.

Ce que l'API permet

Sept capacités, formulées par ce qu'elles font

La documentation n'est pas organisée par table ni par ressource technique, mais par ce qu'un intégrateur cherche à accomplir.

Capacité	La question à laquelle elle répond	État
Ouvrir un dossier	Comment mes utilisateurs entrent-ils dans Medicapp sans double saisie ?	Disponible
Demander une information	Comment déclencher une collecte depuis mon application ?	Disponible
Consulter l'état d'un parcours	Où en est ce dossier, sans ouvrir Medicapp ?	Disponible
Suivre la complétude	Ce dossier est-il prêt à être instruit, et sinon que manque-t-il ?	Disponible
Récupérer les résultats	Comment rapatrier les réponses, les pièces et les scores ?	Disponible
Lancer une campagne de qualification	Comment ouvrir un lot de dossiers depuis mon outil de gestion ?	En cours
Recevoir les événements	Comment être notifié plutôt qu'interroger l'API en boucle ?	En cours

Périmètre assumé. Il ne s'agit pas d'une plateforme d'intégration exhaustive, mais d'une première capacité d'intégration documentée et testable. Une capacité n'est jamais présentée comme disponible si elle ne l'est pas : l'état affiché ci-dessus fait foi.

Modes de déploiement

Quatre manières d'insérer Medicapp Pro

Utilisation directe

Vos équipes travaillent dans Medicapp Pro. Aucune intégration requise pour démarrer.

Complément d'un logiciel métier

Votre logiciel reste le référentiel. Medicapp Pro prend en charge la préparation et renvoie le dossier constitué.

En amont d'une téléconsultation

Le dossier est préparé et contrôlé avant l'attribution du créneau, puis restitué à votre interface.

Intégration progressive

Une capacité d'abord — souvent le suivi de complétude — puis les suivantes, à votre rythme.

Comment cela fonctionne

Trois acteurs, deux directions

Votre système ouvre un dossier et déclenche une demande Votre système
Medicapp recueille, relance et contrôle la complétude Medicapp
La personne suivie répond depuis son mobile Personne suivie
Votre système consulte le statut ou reçoit l'événement Votre système
Votre système récupère le dossier constitué Votre système

Deux portées d'accès distinctes encadrent ces appels : partner:administrative pour l'identité, les statuts et l'avancement, partner:medical pour le contenu de santé. Une intégration purement opérationnelle n'a pas besoin de la seconde.

GET/partner/v5/patients/{uuid}/protocol-status

curl https://secure.medicapp.ids.host/cloud/partner/v5\
/patients/pat_sandbox_001/protocol-status \
  -H "Authorization: Bearer sk_test_…"

200Réponse

{
  "patientUuid": "pat_sandbox_001",
  "protocol": {
    "name": "Protocole pré-opératoire genou",
    "status": "IN_PROGRESS"
  },
  "steps": [
    { "title": "Questionnaire initial",
      "status": "COMPLETED" },
    { "title": "Questionnaire J-7",
      "status": "PENDING" }
  ],
  "dossierStatus": "IN_PROGRESS"
}

Le vocabulaire de la réponse est celui du modèle métier : protocole, étapes, statut de dossier. Il n'y a pas de couche de traduction.

Sécurité de l'intégration

Ce que votre RSSI voudra vérifier

Portées d'accès séparées

Une clé n'obtient que ce que sa portée autorise. L'accès au contenu médical est distinct de l'accès administratif.

Appels tracés

Les accès effectués par l'API relèvent du même historique que les accès humains, avec la même consultation depuis l'application.

Hébergement et localisation

Infrastructure certifiée HDS, données hébergées en France. Documentation de conformité.

Interopérabilité HL7 et FHIR : le périmètre exact effectivement disponible est communiqué au cas par cas, après examen de votre besoin. Nous préférons ne rien annoncer que nous ne puissions démontrer.

Commencer

Un premier appel réussi en cinq minutes

Créez un compte développeur, générez votre clé, appelez le premier point d'accès sur un jeu de test préchargé.

Obtenir une clé de test

Compte développeur, clé sk_test_, tenant de test avec patients fictifs et protocole.

Créer mon compte développeur

Parler du projet

Passage en production, portée médicale, engagement de sécurité, volumétrie.

Contacter l'équipe