anpheros/agent-skills

Backend de saúde Anpheros

O Anpheros armazena o registro de saúde de cada pessoa como recursos HL7 FHIR R4 padrão e expõe os mesmos dados por meio de uma API REST simples (/v1) e FHIR estrita (/fhir/R4). Os IDs são idênticos em ambas.

• URL base: https://platform.anpheros.com (a chave decide sandbox ou produção)
• Guias: https://developers.anpheros.com/guides/ — OpenAPI: /docs — CapabilityStatement: /fhir/R4/metadata
• Servidor MCP de documentação (sem conta, somente leitura): https://platform.anpheros.com/mcp/docs
• SDKs: npm install @anpheros/sdk (TypeScript), anpheros_sdk (Dart/Flutter)

Regras (sempre)

1. Sandbox primeiro. Use uma chave sk_test_: ela só vê os pacientes sintéticos do projeto. Nunca coloque dados reais de pacientes no sandbox e nunca escreva chaves sk_live_ em código, exemplos ou commits; leia as chaves do ambiente (ANPHEROS_KEY).
2. Nunca invente códigos. Códigos LOINC, SNOMED CT, ICD-10, ICD-11, ATC e RxNorm vêm do sistema de código oficial ou da pesquisa de terminologia (GET /v1/search?q=…, GET /v1/search/{id}). Se um código for desconhecido, omita-o. Unidades são UCUM (mg/dL, mmHg, kg).
3. Consentimento é obrigatório. Uma chave de API só vê pacientes que seu projeto criou. Para acessar o registro existente de uma pessoa, solicite a ela por meio do fluxo de consentimento (passo 4 abaixo). Um 403 significa "fora do consentimento": peça mais, nunca contorne. Um 401 após uma revogação significa que o acesso acabou.
4. Diga quem escreveu. Cada gravação carrega author_type (patient, practitioner, device, import, ai). Dados escritos por um modelo usam author_type: "ai" (rótulos HL7 de transparência de IA são adicionados pela plataforma).
5. Nenhum diagnóstico, nenhum conselho de tratamento. O aplicativo pode mostrar registros, tendências e padrões; não deve dizer aos usuários o que eles têm ou qual medicamento tomar.
6. Envie um cabeçalho Idempotency-Key em gravações que possam ser repetidas.

Fluxo de trabalho

1. Chave. O desenvolvedor faz login em https://platform.anpheros.com/dashboard/ e pressiona Obter uma chave de sandbox.
2. Leitura.

   curl $BASE/v1/patients -H "Authorization: Bearer $ANPHEROS_KEY"
   curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $ANPHEROS_KEY"
   curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $ANPHEROS_KEY"
   

3. Gravação.

   curl -X POST "$BASE/v1/patients/$PID/observations" -H "Authorization: Bearer $ANPHEROS_KEY" \
        -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" -d '{
     "code": "2339-0", "display": "Glucose", "category": "laboratory",
     "value": 112, "unit": "mg/dL", "effective_at": "2026-09-19T08:10:00Z", "author_type": "device"}'
   

   Com o SDK:

   import { Anpheros, apiKey } from '@anpheros/sdk';
   const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });
   const patient = await anpheros.patients.create({ given: 'Ana', family: 'Example', birth_date: '1980-05-17', gender: 'female' });
   

4. Consentimento (SMART on FHIR, OAuth 2.1 + PKCE). Registre um aplicativo (POST /admin/projects/{id}/applications), envie a pessoa para GET /oauth/authorize?…&scope=patient/Observation.rs offline_access&purpose=treatment, troque o código em POST /oauth/token, então chame a API com Authorization: Bearer at_…. Descoberta: /.well-known/smart-configuration. Guia: https://developers.anpheros.com/guides/healthcare-api-patient-consent
5. Contexto de IA. POST /v1/context retorna as partes de um registro que se encaixam em um prompt, com proveniência, em vez de despejar recursos brutos no modelo.
6. Importações de exames. Laudos HL7 v2 ORU e CSV: https://developers.anpheros.com/guides/import-lab-results-fhir

Antes de escrever código para um tópico não abordado aqui, pesquise os guias (o servidor MCP de documentação search_docs, ou o índice de guias) em vez de adivinhar endpoints.