Primeros pasos

URL base

La URL base de tu ambiente te la entregamos en el onboarding. En los ejemplos usamos:

https://<gateway-host>

Autenticación

Cada request se autentica con tu API key, en el header x-api-key:

x-api-key: <tu-api-key>

• La API key te la generamos y entregamos nosotros.
• Tiene un allowlist de IPs: los requests deben salir desde una IP registrada. Una request desde una IP no permitida se rechaza con 401.

Headers

Header	Obligatorio	Valor
x-api-key	Sí	Tu API key
Content-Type	Sí	application/fhir+json
x-source-message-id	Sí	Identificador único del envío (ver idempotencia)

El x-source-message-id es tu id de envío: si repetís el mismo, el envío se trata como duplicado y no se reprocesa (ver Respuestas y errores). Usá uno nuevo por cada envío.

Primera llamada

Alta de un paciente:

curl -X POST "https://<gateway-host>/fhir" \
  -H "x-api-key: <tu-api-key>" \
  -H "Content-Type: application/fhir+json" \
  -H "x-source-message-id: 5f3a-0001" \
  -d '{
    "resourceType": "Patient",
    "identifier": [
      { "system": "https://cliente.example.org/ids/patient", "value": "PAC-00" },
      { "system": "https://www.argentina.gob.ar/dni", "value": "20345678" }
    ],
    "active": true,
    "name": [{ "family": "Pérez", "given": ["Juan"] }],
    "birthDate": "1990-01-15"
  }'

Respuesta esperada: 202 Accepted con el id del envío:

{ "id": 12345, "status": "received", "duplicate": false }

El 202 significa recibido, no "procesado": el impacto es asíncrono. Con el id podés consultar el estado del envío en cualquier momento:

curl "https://<gateway-host>/fhir/12345" -H "x-api-key: <tu-api-key>"

Ver Consultar el estado para el detalle del resultado (done / rejected / failed …). A partir del 202 podés enviar el resto de los recursos (episodios, prácticas, documentación) — ver Recursos FHIR.