# Construire avec Anpheros

> Le chemin de l'accès à la production en neuf étapes — authentification, API, données médicales, consentement, FHIR, webhooks, SDK et mise en production — avec le guide pour chaque étape.

Source: https://developers.anpheros.com/fr/guides/build-with-anpheros

**Construire sur Anpheros signifie l'utiliser comme couche de données médicales de votre application : votre produit appelle l'API Anpheros pour stocker et lire les dossiers des patients en HL7 FHIR R4, pour obtenir le consentement du patient et pour recevoir des événements.** Cette page est la carte du premier accès à la production ; chaque étape renvoie au guide qui la couvre en détail.

## 1. Obtenir l'accès

La plateforme Anpheros est en bêta privée. L'environnement sandbox est en libre-service : connectez-vous avec Google sur le tableau de bord (`https://platform.anpheros.com/dashboard/`) et appuyez sur *Obtenir une clé sandbox* — vous obtenez une organisation, un projet sandbox avec ses 30 patients synthétiques propres, et une clé. L'accès en production se fait sur demande (`contact@anpheros.com`). Vous créez d'autres projets et clés d'API dans le tableau de bord ou via l'API d'administration ; les applications OAuth sont enregistrées avec `POST /admin/projects/{id}/applications` et les webhooks avec `POST /v1/webhooks`.

Un **projet** est l'unité d'isolation : ses clés ne voient que les patients qu'il a créés (et, avec consentement, ceux qui lui ont accordé l'accès).

## 2. Authentification

| Identifiant | Pour | Aspect |
|---|---|---|
| Clé API | vos serveurs | `sk_test_…` (sandbox), `sk_live_…` (production) |
| Jeton d'accès OAuth | une application agissant pour un patient | `at_…`, valide 30 minutes, renouvelé avec un jeton de rafraîchissement rotatif |

Envoyez-le comme `Authorization: Bearer <credential>`. Les clés sont affichées une seule fois et n'appartiennent jamais à une application mobile ou web. → [Authentification et OAuth](https://developers.anpheros.com/fr/guides/authentication)

## 3. Connexion à l'API

URL de base `https://platform.anpheros.com` ; REST à `/v1`, FHIR R4 à `/fhir/R4`. La référence interactive et la spécification OpenAPI décrivent chaque point de terminaison.

```bash
curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"
```

→ [Référence de l'API](https://developers.anpheros.com/docs) · [API Santé](https://developers.anpheros.com/fr/guides/healthcare-api)

## 4. Créer et lire des données médicales

Créez un patient pour chacun de vos utilisateurs, écrivez des observations, des conditions, des médicaments et des documents avec un `Idempotency-Key`, et relisez-les sous forme de listes ou de chronologie. Indiquez l'auteur de chaque écriture (`patient`, `practitioner`, `device`, `import`, `ai`).

→ [Démarrage](https://developers.anpheros.com/fr/guides/getting-started) · [API de données médicales](https://developers.anpheros.com/fr/guides/medical-data-api) · [Créer une application de santé](https://developers.anpheros.com/fr/guides/build-a-healthcare-app)

## 5. Ajouter le consentement

Pour accéder à un dossier qu'une personne conserve déjà dans Anpheros, enregistrez une application OAuth avec son URI de redirection, envoyez la personne à la page de consentement avec les scopes dont vous avez besoin, et échangez le code (PKCE) contre des tokens. La personne choisit la durée et peut révoquer l'accès à tout moment ; chaque lecture lui est visible.

→ [Modèle de consentement et d'accès](https://developers.anpheros.com/fr/guides/consent) · [Authentification et OAuth](https://developers.anpheros.com/fr/guides/authentication)

## 6. Utilisez FHIR lorsque vous avez besoin du modèle complet

Les types de ressources au-delà de l'API REST — immunisations, procédures, plans de soins, allergies, rencontres et autres, 26 au total — sont disponibles via FHIR R4, ainsi que la recherche, l'historique, les transactions, `$everything` et le Résumé International du Patient (`$summary`).

→ [Plateforme FHIR](https://developers.anpheros.com/fr/guides/fhir) · [Systèmes de codes FHIR](https://developers.anpheros.com/fr/guides/fhir-code-systems) · [Interopérabilité des données de santé](https://developers.anpheros.com/fr/guides/interoperability)

## 7. Réagir aux événements

Enregistrez un point de terminaison de webhook pour les événements `resource.*`, `consent.*` ou `document.finalized` et vérifiez le `Anpheros-Signature` de chaque livraison. Les rapports de laboratoire peuvent être envoyés en un seul appel au connecteur de laboratoire.

→ [Webhooks](https://developers.anpheros.com/fr/guides/webhooks) · [Connecteur de laboratoire](https://developers.anpheros.com/fr/guides/lab-connector) · [Intégrations de soins de santé](https://developers.anpheros.com/fr/guides/healthcare-integrations)

## 8. Utiliser un SDK

`@anpheros/sdk` (TypeScript : Node 18+, navigateurs, Deno, Bun) et `anpheros_sdk` (Dart / Flutter) couvrent l'intégralité de l'API publique avec la même structure, ajoutent des clés d'idempotence aux créations, retentent en cas de `429`/`5xx`, actualisent les jetons et implémentent le flux de consentement.

```bash
npm install @anpheros/sdk        # or: dart pub add anpheros_sdk
```

→ [SDKs](https://developers.anpheros.com/fr/guides/sdks)

## 9. Passer en production

- Les clés de production (`sk_live_`) sont délivrées aux organisations vérifiées ayant signé un accord de traitement des données.
- Prévoyez les limites de la beta privée : zone unique, pas de SLA contractuel, 600 requêtes par minute par clé et par IP.
- Gérez les erreurs par type et conservez `Anpheros-Request-Id` pour le support.
- Examinez comment les données sont protégées et où elles sont stockées.

→ [Sécurité, confidentialité et résidence des données](https://developers.anpheros.com/fr/guides/security) · [Limites](https://developers.anpheros.com/fr/guides/limits) · [Erreurs](https://developers.anpheros.com/fr/guides/errors) · [Versionnement et obsolescence](https://developers.anpheros.com/fr/guides/versioning)

## Ajout de l'IA

Si votre produit inclut un assistant ou un agent IA, l'API de contexte prépare la partie pertinente d'un enregistrement pour le modèle que vous utilisez, dans une limite de jetons et avec chaque élément étiqueté par sa source. → [Applications d'IA dans le domaine de la santé](https://developers.anpheros.com/fr/guides/ai-healthcare)

## Liens connexes

- [Anpheros pour les développeurs](https://developers.anpheros.com/fr/guides/developers)
- [Développement de logiciels de santé](https://developers.anpheros.com/fr/guides/healthcare-software)
- [Startups dans le domaine de la santé](https://developers.anpheros.com/fr/guides/healthcare-startups)
