Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Aperta Adatta ai principianti
  • Qualcosa non va?
#4,230 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
1/5
Tempo stimato
Meno di un'ora
Idoneità per principianti
88/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
openapi
Ambito
api, documentation

Direzione di ricerca

Apri docs/_static/auth/v2.yaml intorno alle righe 188-189, quindi confronta la risposta alla richiesta delle credenziali con gli schemi RedirectResponse e RedirectResponseWithID intorno alle righe 552 e 562. Conferma che la risposta documentata corrisponda al comportamento attuale e assicurati che la descrizione completa non affermi più la presenza di una session_id quando lo schema indicato non ne restituisce una.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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

Lingua principale
Go
Stelle
29
Fork
24
Merge medio
2g 18h
PR unite (30g)
45

Preparare l'ambiente

  • Include un Dockerfile o un file Docker Compose
  • Nessun modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di nuts-foundation/nuts-node

Tutte le issue di nuts-foundation/nuts-node

Issue simili

Altre issue su Go

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.