OAuth

Início do fluxo de autorização (navegador).

O navegador da pessoa chega aqui vindo do cliente. O servidor valida o par client_id e redirect_uri e manda a pessoa para a tela de consentimento do Juspronto (/conectar), onde ela entra com o login, confere quem pede o acesso e marca as permissões. O parâmetro scope enviado pelo cliente NÃO concede permissão nenhuma: quem escolhe as permissões é a pessoa, na tela. Só openid e email, se pedidos, ficam registrados na conexão, e apenas habilitam o endereço userinfo. PKCE S256 é obrigatório. Toda resposta que volta ao cliente, de sucesso ou de erro, leva iss (RFC 9207). Cliente ou endereço de retorno não registrados nunca redirecionam: respondem 400 com uma página de erro.

get/api/mcp-oauth/authorize

Request

  • Base URL: https://api.juspronto.com.br
  • URL: https://api.juspronto.com.br/api/mcp-oauth/authorize
  • Auth: none required

Query parameters

client_idstring required

Identificador devolvido pelo registro de cliente.

redirect_uristring uri required

Endereço de retorno registrado para este cliente.

response_type'code' required

Sempre code.

code_challengestring required

Desafio PKCE: SHA-256 do code_verifier em base64url.

code_challenge_method'S256' required

Sempre S256.

statestring

Valor opaco devolvido ao cliente no retorno.

scopestring

Escopos que o cliente gostaria de receber. Não concede permissão: vale o que a pessoa marcar na tela. openid e email só habilitam o userinfo.

resourcestring uri

Recurso para o qual o token vale (RFC 8707). Opcional; o do conector é https://api.juspronto.com.br/api/mcp. Outro valor volta ao cliente como invalid_target.

Changes

No recorded changes to this operation across all 1 revision of this API.