Eu preciso editar alguma coisa antes de usar?

Não. Cada URL no documento é escrita como o token {{mock.url}}, que se expande para o próprio endereço https://quickmock.dev/m/<slug> deste mock em cada solicitação — então o documento é auto-consistente no momento em que você o cria. Você só precisa editá-lo se quiser que os endpoints apontem para outro lugar.

Por que o emissor tem que corresponder exatamente?

Os clientes comparam o emissor neste documento com a declaração (claim) iss dos tokens que recebem, e rejeitam uma incompatibilidade. Uma barra final é o suficiente para quebrá-lo, o que torna isso uma coisa útil para testar deliberadamente.

Posso concluir um fluxo de login real contra ele?

Não. O documento anuncia endpoints, mas nada os implementa. Junte-o ao modelo de token OAuth2 para o passo de token e o modelo JWKS para a descoberta de chave para cobrir mais do fluxo.

Simular um documento de descoberta OpenID Connect

Um mock GET em /.well-known/openid-configuration com issuer, authorization_endpoint, token_endpoint e jwks_uri.

Os clientes do OpenID Connect fazem bootstrap buscando um documento de descoberta de /.well-known/openid-configuration e lendo os endpoints nele. Este modelo serve esse documento, para que você possa testar o passo de descoberta — e o tratamento do seu cliente sobre isso — sem precisar configurar um provedor de identidade.

Substitui um endpoint de API de terceiros.

Payload de resposta

{"issuer":"{{mock.url}}","authorization_endpoint":"{{mock.url}}/authorize","token_endpoint":"{{mock.url}}/token","jwks_uri":"{{mock.url}}/.well-known/jwks.json","response_types_supported":["code"],"subject_types_supported":["public"],"id_token_signing_alg_values_supported":["RS256"]}

Campos que valem a pena conhecer

Campo	O que significa
issuer	A URL do emissor (issuer) que os clientes comparam com a declaração iss de um token; ela deve corresponder exatamente à URL base.
authorization_endpoint	Onde um cliente envia o usuário para fazer login.
token_endpoint	Onde um cliente troca um código por tokens.
jwks_uri	Onde um cliente busca as chaves públicas — faz par com o modelo jwks-endpoint.

Criar o mock

curl -X POST https://quickmock.dev/api/mocks \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "GET",
  "response_status": 200,
  "content_type": "application/json",
  "path_suffix": ".well-known/openid-configuration",
  "response_body": "{\"issuer\":\"{{mock.url}}\",\"authorization_endpoint\":\"{{mock.url}}/authorize\",\"token_endpoint\":\"{{mock.url}}/token\",\"jwks_uri\":\"{{mock.url}}/.well-known/jwks.json\",\"response_types_supported\":[\"code\"],\"subject_types_supported\":[\"public\"],\"id_token_signing_alg_values_supported\":[\"RS256\"]}"
}'

Chame-o

curl https://quickmock.dev/m/<slug>/.well-known/openid-configuration

O que você obtém

GET /m/<slug>/.well-known/openid-configuration -> 200 an OIDC discovery document
every advertised endpoint resolves to this mock via the {{mock.url}} token

Como isso difere do original

Cada URL neste documento é construída a partir do token {{mock.url}}, de modo que resolve para o próprio endereço deste mock em cada solicitação — mas nada por trás desses endpoints está implementado, de modo que um cliente pode concluir a descoberta e nenhum passo adicional. A edição do corpo da resposta requer o token de administrador do banner de criação; consulte /guide/manage-mocks-from-any-device para saber como isso funciona.

Fontes

FAQ

Eu preciso editar alguma coisa antes de usar?: Não. Cada URL no documento é escrita como o token {{mock.url}}, que se expande para o próprio endereço https://quickmock.dev/m/<slug> deste mock em cada solicitação — então o documento é auto-consistente no momento em que você o cria. Você só precisa editá-lo se quiser que os endpoints apontem para outro lugar.
Por que o emissor tem que corresponder exatamente?: Os clientes comparam o emissor neste documento com a declaração (claim) iss dos tokens que recebem, e rejeitam uma incompatibilidade. Uma barra final é o suficiente para quebrá-lo, o que torna isso uma coisa útil para testar deliberadamente.
Posso concluir um fluxo de login real contra ele?: Não. O documento anuncia endpoints, mas nada os implementa. Junte-o ao modelo de token OAuth2 para o passo de token e o modelo JWKS para a descoberta de chave para cobrir mais do fluxo.

Pronto para usar?

Abrir no construtor de mocks para ajustar primeiro

Combina bem com este guia: Simular um endpoint de API REST

Modelos relacionados

← Todos os modelos

Última atualização: 2026-10-17