Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

OpenAPI: /request-credential description mentions session_id but schema doesn't return it

Abierto Apto para principiantes
#4,230 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
88/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Tranquilo
Stack tecnológico
openapi

Línea de trabajo

Abre docs/_static/auth/v2.yaml alrededor de las líneas 188-189 y, a continuación, compara la respuesta de solicitud de credenciales con los esquemas RedirectResponse y RedirectResponseWithID alrededor de las líneas 552 y 562. Confirma que la respuesta documentada coincide con el comportamiento actual y asegúrate de que la descripción completa ya no afirme que existe una session_id cuando el esquema referenciado no devuelve ninguna.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Problem

The POST /internal/auth/v2/{subjectID}/request-credential endpoint in docs/_static/auth/v2.yaml has a misleading response description.

The description on the 200 response says:

Successful request. Responds with a redirect_uri for the user and a session_id for correlation.

However, the schema referenced by that response is RedirectResponse, which only contains redirect_uri — no session_id. The session_id field belongs to RedirectResponseWithID, used by other endpoints (e.g. request-user-access-token).

See:

  • Description: docs/_static/auth/v2.yaml around line 188-189
  • RedirectResponse schema: docs/_static/auth/v2.yaml:552
  • RedirectResponseWithID schema: docs/_static/auth/v2.yaml:562

Fix options

Either:

  1. Update the description to drop the session_id mention (if no correlation ID is actually needed for this flow), or
  2. Change the response schema to RedirectResponseWithID and have the implementation return a session_id (if correlation is intended).

Option 1 matches current behavior; option 2 would be a behavioral change.

Assisted by AI

Lenguaje dominante
Go
Estrellas
29
Forks
24
Merge medio
2 d 18 h
PR fusionados (30 d)
45

Preparar el entorno

  • Incluye un Dockerfile o un archivo de Docker Compose
  • Sin plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de nuts-foundation/nuts-node

Todos los issues de nuts-foundation/nuts-node

Issues similares

Más issues de Go

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.