Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Construir com Anpheros
O caminho do acesso à produção em nove passos — autenticação, API, dados médicos, consentimento, FHIR, webhooks, SDKs e entrada em produção — com o guia para cada passo.
Construir sobre Anpheros significa utilizá-lo como a camada de dados médicos da sua aplicação: o seu produto chama a API Anpheros para armazenar e ler registos de pacientes em HL7 FHIR R4, para obter o consentimento do paciente e para receber eventos. Esta página é o mapa desde o primeiro acesso até à produção; cada passo liga ao guia que o cobre em detalhe.
1. Obter acesso
A Plataforma Anpheros está em beta privado. A sandbox é self-service: inicie sessão com o Google no dashboard (https://platform.anpheros.com/dashboard/) e prima Obter uma chave de sandbox — recebe uma organização, um projeto de sandbox com os seus próprios 30 pacientes sintéticos e uma chave. O acesso à produção é mediante pedido ([email protected]). Cria projetos adicionais e chaves de API no dashboard ou através da Admin API; as aplicações OAuth são registadas com POST /admin/projects/{id}/applications e os webhooks com POST /v1/webhooks.
Um projeto é a unidade de isolamento: as suas chaves apenas veem os pacientes que criou (e, com consentimento, aqueles que lhe concederam acesso).
2. Autenticar
| Credencial | Para | Parece |
|---|---|---|
| Chave de API | os seus servidores | sk_test_… (sandbox), sk_live_… (produção) |
| Token de acesso OAuth | uma aplicação a agir em nome de um paciente | at_…, válido por 30 minutos, atualizado com um token de atualização rotativo |
Envie-o como Authorization: Bearer <credential>. As chaves são mostradas uma vez e nunca devem pertencer a uma aplicação móvel ou web. → Autenticação e OAuth
3. Ligar à API
URL base https://platform.anpheros.com; REST em /v1, FHIR R4 em /fhir/R4. A referência interativa e a especificação OpenAPI descrevem todos os endpoints.
curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"
→ Referência da API · API de Saúde
4. Criar e ler dados médicos
Crie um paciente para cada um dos seus utilizadores, escreva observações, condições, medicamentos e documentos com um Idempotency-Key, e leia-os de volta como listas ou uma linha cronológica. Indique o autor de cada escrita (patient, practitioner, device, import, ai).
→ Introdução · API de dados médicos · Criar uma aplicação de saúde
5. Adicionar consentimento
Para aceder a um registo que uma pessoa já mantém no Anpheros, registe uma aplicação OAuth com o seu URI de redirecionamento, envie a pessoa para a página de consentimento com os escopos de que necessita e troque o código (PKCE) por tokens. A pessoa escolhe a duração e pode revogar o acesso a qualquer momento; cada leitura é visível para ela.
→ Modelo de consentimento e acesso · Autenticação e OAuth
6. Utilize FHIR quando necessitar do modelo completo
Tipos de recursos para além da API REST — imunizações, procedimentos, planos de cuidados, alergias, encontros e outros, num total de 26 — estão disponíveis através do FHIR R4, juntamente com pesquisa, histórico, transações, $everything e o Resumo Internacional do Doente ($summary).
→ Plataforma FHIR · Sistemas de código FHIR · Interoperabilidade de dados de saúde
7. Reagir a eventos
Registe um endpoint de webhook para eventos resource.*, consent.* ou document.finalized e verifique o Anpheros-Signature de cada entrega. Relatórios laboratoriais podem ser enviados numa única chamada para o conector de laboratório.
→ Webhooks · Conector de laboratório · Integrações de saúde
8. Utilizar um SDK
@anpheros/sdk (TypeScript: Node 18+, navegadores, Deno, Bun) e anpheros_sdk (Dart / Flutter) cobrem toda a API pública com a mesma estrutura, adicionam chaves de idempotência a criações, tentam novamente em caso de 429/5xx, atualizam tokens e implementam o fluxo de consentimento.
npm install @anpheros/sdk # or: dart pub add anpheros_sdk
→ SDKs
9. Ir para produção
- As chaves de produção (
sk_live_) são emitidas para organizações verificadas com um acordo de processamento de dados assinado. - Planeie os limites da beta privada: zona única, sem SLA contratual, 600 pedidos por minuto por chave e por IP.
- Trate os erros por tipo e guarde
Anpheros-Request-Idpara suporte. - Reveja como os dados são protegidos e onde são armazenados.
→ Segurança, privacidade e residência de dados · Limites · Erros · Versionamento e descontinuação
Adicionar IA
Se o seu produto incluir um assistente ou agente de IA, a API de contexto prepara a parte relevante de um registo para o modelo que utiliza, dentro de um limite de tokens e com cada item rotulado pela origem. → Aplicações de IA na saúde
Relacionado
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card