# Construye con Anpheros

> El camino desde el acceso hasta la producción en nueve pasos — autenticación, API, datos médicos, consentimiento, FHIR, webhooks, SDKs y puesta en marcha — con la guía para cada paso.

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

**Construir sobre Anpheros significa usarlo como la capa de datos médicos de tu aplicación: tu producto llama a la API de Anpheros para almacenar y leer registros de pacientes en HL7 FHIR R4, para obtener el consentimiento del paciente y para recibir eventos.** Esta página es el mapa desde el primer acceso hasta la producción; cada paso enlaza a la guía que lo cubre en detalle.

## 1. Obtener acceso

La Plataforma Anpheros se encuentra en beta privada. El sandbox es de autoservicio: inicie sesión con Google en el panel (`https://platform.anpheros.com/dashboard/`) y presione *Obtener una clave de sandbox* — obtendrá una organización, un proyecto de sandbox con sus propios 30 pacientes sintéticos y una clave. El acceso a producción es bajo solicitud (`contact@anpheros.com`). Puede crear proyectos adicionales y claves de API en el panel o a través de la API de administración; las aplicaciones OAuth se registran con `POST /admin/projects/{id}/applications` y los webhooks con `POST /v1/webhooks`.

Un **proyecto** es la unidad de aislamiento: sus claves solo ven los pacientes que creó (y, con consentimiento, aquellos que le otorgaron acceso).

## 2. Autenticar

| Credencial | Para | Parece |
|---|---|---|
| Clave de API | tus servidores | `sk_test_…` (sandbox), `sk_live_…` (producción) |
| Token de acceso OAuth | una aplicación que actúa en nombre de un paciente | `at_…`, válido por 30 minutos, refrescado con un token de refresco rotatorio |

Envíalo como `Authorization: Bearer <credential>`. Las claves se muestran una vez y nunca deben estar en una aplicación móvil o web. → [Autenticación y OAuth](https://developers.anpheros.com/es/guides/authentication)

## 3. Conectar a la API

URL base `https://platform.anpheros.com`; REST en `/v1`, FHIR R4 en `/fhir/R4`. La referencia interactiva y la especificación OpenAPI describen cada endpoint.

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

→ [Referencia de la API](https://developers.anpheros.com/docs) · [API de Salud](https://developers.anpheros.com/es/guides/healthcare-api)

## 4. Crear y leer datos médicos

Cree un paciente para cada uno de sus usuarios, escriba observaciones, condiciones, medicamentos y documentos con un `Idempotency-Key`, y léalos de nuevo como listas o una línea de tiempo. Indique el autor de cada escritura (`patient`, `practitioner`, `device`, `import`, `ai`).

→ [Primeros pasos](https://developers.anpheros.com/es/guides/getting-started) · [API de datos médicos](https://developers.anpheros.com/es/guides/medical-data-api) · [Crear una aplicación de atención médica](https://developers.anpheros.com/es/guides/build-a-healthcare-app)

## 5. Añadir consentimiento

Para acceder a un registro que una persona ya mantiene en Anpheros, registre una aplicación OAuth con su URI de redirección, envíe a la persona a la página de consentimiento con los ámbitos que necesita e intercambie el código (PKCE) por tokens. La persona elige la duración y puede revocar el acceso en cualquier momento; cada lectura es visible para ella.

→ [Modelo de consentimiento y acceso](https://developers.anpheros.com/es/guides/consent) · [Autenticación y OAuth](https://developers.anpheros.com/es/guides/authentication)

## 6. Utilice FHIR cuando necesite el modelo completo

Los tipos de recursos más allá de la API REST —inmunizaciones, procedimientos, planes de atención, alergias, encuentros y otros, 26 en total— están disponibles a través de FHIR R4, junto con búsqueda, historial, transacciones, `$everything` y el Resumen Internacional del Paciente (`$summary`).

→ [Plataforma FHIR](https://developers.anpheros.com/es/guides/fhir) · [Sistemas de código FHIR](https://developers.anpheros.com/es/guides/fhir-code-systems) · [Interoperabilidad de datos de salud](https://developers.anpheros.com/es/guides/interoperability)

## 7. Reaccionar a eventos

Registre un endpoint de webhook para eventos `resource.*`, `consent.*` o `document.finalized` y verifique el `Anpheros-Signature` de cada entrega. Los informes de laboratorio se pueden enviar en una sola llamada al conector de laboratorio.

→ [Webhooks](https://developers.anpheros.com/es/guides/webhooks) · [Conector de laboratorio](https://developers.anpheros.com/es/guides/lab-connector) · [Integraciones de atención médica](https://developers.anpheros.com/es/guides/healthcare-integrations)

## 8. Usar un SDK

`@anpheros/sdk` (TypeScript: Node 18+, navegadores, Deno, Bun) y `anpheros_sdk` (Dart / Flutter) cubren toda la API pública con la misma estructura, añaden claves de idempotencia a las creaciones, reintentan en `429`/`5xx`, actualizan tokens e implementan el flujo de consentimiento.

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

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

## 9. Pasar a producción

- Las claves de producción (`sk_live_`) se emiten a organizaciones verificadas con un acuerdo de procesamiento de datos firmado.
- Planifique los límites de la beta privada: zona única, sin SLA contractual, 600 solicitudes por minuto por clave y por IP.
- Maneje los errores por tipo y conserve `Anpheros-Request-Id` para soporte.
- Revise cómo se protegen los datos y dónde se almacenan.

→ [Seguridad, privacidad y residencia de datos](https://developers.anpheros.com/es/guides/security) · [Límites](https://developers.anpheros.com/es/guides/limits) · [Errores](https://developers.anpheros.com/es/guides/errors) · [Versiones y obsolescencia](https://developers.anpheros.com/es/guides/versioning)

## Añadiendo IA

Si tu producto incluye un asistente o agente de IA, la API de contexto prepara la parte relevante de un registro para el modelo que utilices, dentro de un presupuesto de tokens y con cada elemento etiquetado por su origen. → [Aplicaciones de IA en salud](https://developers.anpheros.com/es/guides/ai-healthcare)

## Relacionado

- [Anpheros para desarrolladores](https://developers.anpheros.com/es/guides/developers)
- [Desarrollo de software para la salud](https://developers.anpheros.com/es/guides/healthcare-software)
- [Startups de salud](https://developers.anpheros.com/es/guides/healthcare-startups)
