Exemplos de contrato
Modelos sintéticos para alinhar o desenvolvimento. Não são endpoints nem payloads oficiais do Tasy.
Atualizado em 21 de setembro de 2026
Envelope canônico sugerido
{
"schemaVersion": "1",
"source": "tasy",
"environment": "homologacao",
"tenantId": "empresa-teste",
"eventId": "evento-sintetico-001",
"entityType": "professional",
"externalId": "profissional-teste-001",
"sourceVersion": "42",
"occurredAt": "2026-09-21T12:00:00Z",
"operation": "upsert",
"data": {
"displayName": "Profissional de teste",
"active": true,
"unitExternalIds": ["unidade-teste-01"]
}
}O receptor deve vincular a empresa à credencial técnica, validar o schema, deduplicar pelo evento e manter uma chave por entidade. O campo sourceVersion só pode ordenar atualizações se a origem oferecer uma versão comparável. Não converter uma string arbitrária em uma garantia de ordenação.
Consulta de capacidades FHIR · condicional
GET https://fhir-homologacao.example.invalid/metadata
Accept: application/fhir+json
# Autenticação: conforme documentação fornecida.
# Resposta esperada no padrão: recurso CapabilityStatement.
# Não comprova suporte de Practitioner, preços ou agendas.- HL7 · FHIR R4 RESTful APIContrato do padrão FHIR R4; não comprova que o ambiente Tasy possua esse serviço.
- HL7 · CapabilityStatement R4Como declarar e verificar capacidades de um servidor FHIR.
Política de erros sugerida
| Resposta / situação | Ação do futuro conector |
|---|---|
| 401 | Renovar credencial apenas conforme contrato, uma vez; persistindo, interromper e alertar. |
| 403 | Revisar escopo, empresa e autorização. Não repetir indefinidamente. |
| 404 | Confirmar contrato, versão e existência do recurso; não adivinhar outra rota. |
| 409 | Investigar conflito de versão ou duplicidade; não considerar sucesso sem consultar a semântica. |
| 422 ou erro de validação | Separar registro para correção; preservar causa sem dados sensíveis nos logs. |
| 429 | Respeitar Retry-After se enviado; aplicar espera progressiva e limite de tentativas. |
| 5xx / timeout | Aplicar tentativas limitadas com variação de espera; depois suspender e alertar. |
| SOAP Fault / ACK negativo | Interpretar o código de negócio definido pelo fornecedor; HTTP 200 não garante sucesso. |