Skip to content
Documentação IntegraDoor

Operadoras

Visão Geral

Este documento descreve os endpoints que devem ser fornecidos pela Operadora parceira ao IntegraDoor para fins de conciliação de dados. A API garante o recebimento seguro de informações de consentimento e dados de resultados, utilizando criptografia RSA conforme as diretrizes da LGPD.

Base URL esperada: https://{dominio-operadora}/ Autenticação: OAuth 2.0 com client_credentials

Autenticação

  • Token URL sugerido: https://auth.operadora.com.br/oauth/token
  • Scopes esperados:
    • read:consentimento
    • write:resultado
    • read:public-key
    • write:public-key

Endpoints

1. Retornar Consentimento

GET /consentimento/{carteira}

Consulta ao sistema da operadora sobre o status do consentimento digital do beneficiário.

Parâmetros:

NomeTipoLocalObrigatórioDescrição
carteirastringpathSimNúmero da carteira do beneficiário
keyIdstringqueryNãoIdentificador da chave pública para criptografia

Exemplo de resposta:

{
  "id": 20250120153622,
  "nomeBeneficiario": "JONNY QUEST",
  "dataConsentimento": "2025-01-20T15:36:22Z",
  "dataNascimento": "1980-06-10T00:00:00Z",
  "status": "autorizado",
  "georreferenciamento": {
    "query": "177.212.238.49",
    "lat": -19.9029,
    "lon": -43.9572,
    "isp": "Vivo",
    "org": "TELEFÔNICA BRASIL S.A",
    "mobile": false
  }
}

2. Receber Dados Conciliados

POST /conciliacao/receber

O IntegraDoor irá enviar os dados conciliados para este endpoint conforme os identificadores da autorização.

Parâmetros opcionais (query):

  • guiaOperadora
  • guiaPrestador
  • senha

Corpo da Requisição:

{
  "id": 10,
  "name": "Resultado de exames laboratoriais",
  "data": {
    "codigoProcedimento": "ABC123",
    "valor": "Reagente"
  }
}

Resposta esperada:

[
  {
    "id": 10,
    "name": "Resultado de exames laboratoriais",
    "data": {
      "codigoProcedimento": "ABC123",
      "valor": "Reagente"
    }
  }
]

Gerenciamento de Chaves Públicas

Obter Chave Pública do IntegraDoor

GET /seguranca/public-key Lista os keyId registrados previamente.

Enviar Chave Pública do IntegraDoor

POST /seguranca/public-key

{
  "keyId": "client-key-2025",
  "publicKey": "-----BEGIN PUBLIC KEY-----\\nMIIBIjANBgkq..."
}

Remover Chave Pública

DELETE /seguranca/public-key?keyId=client-key-2025

Obter Chave Pública da Operadora

GET /seguranca/public-key/servidor Utilizada para criptografia de dados sensíveis.

Considerações de Segurança e LGPD

  • Os dados devem ser tratados com base no consentimento informado pelo beneficiário.
  • A criptografia RSA (OAEP com SHA-256) deve ser utilizada para transmissão segura.
  • O IntegraDoor gerencia e mantém as chaves públicas utilizadas na comunicação segura.
  • O modelo de integração deve permitir múltiplos envios por autorização.