# 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. Source: https://developers.anpheros.com/pt/guides/build-with-anpheros **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 (`contact@anpheros.com`). 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 `. As chaves são mostradas uma vez e nunca devem pertencer a uma aplicação móvel ou web. → [Autenticação e OAuth](https://developers.anpheros.com/pt/guides/authentication) ## 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. ```bash curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY" ``` → [Referência da API](https://developers.anpheros.com/docs) · [API de Saúde](https://developers.anpheros.com/pt/guides/healthcare-api) ## 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](https://developers.anpheros.com/pt/guides/getting-started) · [API de dados médicos](https://developers.anpheros.com/pt/guides/medical-data-api) · [Criar uma aplicação de saúde](https://developers.anpheros.com/pt/guides/build-a-healthcare-app) ## 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](https://developers.anpheros.com/pt/guides/consent) · [Autenticação e OAuth](https://developers.anpheros.com/pt/guides/authentication) ## 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](https://developers.anpheros.com/pt/guides/fhir) · [Sistemas de código FHIR](https://developers.anpheros.com/pt/guides/fhir-code-systems) · [Interoperabilidade de dados de saúde](https://developers.anpheros.com/pt/guides/interoperability) ## 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](https://developers.anpheros.com/pt/guides/webhooks) · [Conector de laboratório](https://developers.anpheros.com/pt/guides/lab-connector) · [Integrações de saúde](https://developers.anpheros.com/pt/guides/healthcare-integrations) ## 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. ```bash npm install @anpheros/sdk # or: dart pub add anpheros_sdk ``` → [SDKs](https://developers.anpheros.com/pt/guides/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-Id` para suporte. - Reveja como os dados são protegidos e onde são armazenados. → [Segurança, privacidade e residência de dados](https://developers.anpheros.com/pt/guides/security) · [Limites](https://developers.anpheros.com/pt/guides/limits) · [Erros](https://developers.anpheros.com/pt/guides/errors) · [Versionamento e descontinuação](https://developers.anpheros.com/pt/guides/versioning) ## 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](https://developers.anpheros.com/pt/guides/ai-healthcare) ## Relacionado - [Anpheros para programadores](https://developers.anpheros.com/pt/guides/developers) - [Desenvolvimento de software para a saúde](https://developers.anpheros.com/pt/guides/healthcare-software) - [Startups na área da saúde](https://developers.anpheros.com/pt/guides/healthcare-startups)