Todas as operações

Verifica clientId + secretKey (bcrypt contra o secretKeyHash guardado em partners) e emite um token de parceiro de curta duração, usado como Bearer token em POST /v1/partners/sessions.

Resolve o escopo de módulos (piso regulatório do conselho do profissional cruzado com o teto comercial do parceiro), valida customFields contra o customFieldsSchema do parceiro, grava o snapshot em prescription_sessions e devolve o embeddedToken usado pelo bundle em GET /v1/partners/sessions/validate. Requer o token de parceiro emitido em POST /v1/partners/authenticate.

Recebe o embeddedToken (no corpo da requisição) e o patient com os dados atualizados. Refaz o upsert do patient (incluindo patient.address) e devolve um embeddedToken novo — o bundle precisa substituir o token salvo pelo novo a partir dessa resposta. Sem token de parceiro: a própria sessão encriptada é a autoridade, igual em GET /v1/partners/sessions/validate.

Encerra a sessão de prescrição. O embeddedToken pode vir como Bearer token ou como query string.

Chamada a cada carga do bundle no browser do médico. Sem leitura no Mongo: decripta o embeddedToken, que carrega o contexto inteiro da sessão (partner, professional, patient, scopes, featureFlags), e confere se ainda está ativa. Não renova o expiresAt — para isso, ver POST /v1/partners/sessions/renew. O embeddedToken pode vir como Bearer token ou como query string.

Empurra o expiresAt (renovação deslizante), sem nunca ultrapassar o teto de vida absoluto da sessão (createdAt + absolute_ttl_seconds), e devolve um embeddedToken novo — o bundle precisa substituir o token salvo pelo novo a partir dessa resposta. O embeddedToken pode vir como Bearer token ou como query string.