Para usar os serviços, seu sistema pede um token com o acesso fornecido pela Rdicom. Esse token será enviado nas próximas chamadas. Esse processo é chamado de OAuth Client Credentials.

1. Receba seus dados de acesso

Dado Para que serve
Endereço do ambiente URL da API liberada para os seus testes ou para produção.
client_id Identifica o acesso da sua integração.
client_secret Segredo usado para obter o token. Guarde somente no servidor do seu sistema.
server_uuid Identifica o servidor de destino nas rotas que já usam esse valor no endereço, como o envio de agendamentos.

A Rdicom também informa quais serviços estão liberados. Os dados de acesso são entregues por canal seguro, fora desta documentação.

2. Obtenha o token

Método: POST Endpoint: /api/oauth/token

No Postman, use Authorization → Basic Auth: informe client_id em Username e client_secret em Password. Aqui são as credenciais da integração; não use a conta do centro médico.

Em Body → x-www-form-urlencoded, informe:

Campo Valor
grant_type client_credentials

Resposta esperada: HTTP 200. Exemplo fictício:

{
  "access_token": "rdp_TOKEN_DE_EXEMPLO",
  "token_type": "Bearer",
  "expires_in": 300
}

O token vale por cinco minutos. Reutilize-o durante esse período; quando expirar, obtenha outro. A resposta também pode informar os serviços liberados no campo scope; não é necessário preencher esse campo para começar.

Exemplo cURL

Substitua as variáveis pelos dados recebidos da Rdicom:

curl --request POST "$BASE_URL/api/oauth/token" \
  --user "$CLIENT_ID:$CLIENT_SECRET" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'grant_type=client_credentials'

3. Envie o token nas chamadas

Na aba Authorization, escolha Bearer Token e informe o access_token recebido. O cabeçalho enviado será:

Authorization: Bearer TOKEN_RECEBIDO

Com OAuth, você não precisa enviar login/senha do CDI, JWT de usuário ou a chave antiga X-Rdicom-Partner-Key. Nas rotas que recebiam o parâmetro token do centro médico, esse parâmetro pode ser omitido. O servidor usa o destino do seu acesso. Se mantiver os IDs ou o UUID existentes, eles devem corresponder à integração liberada.

Usar a coleção pronta