Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

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

未关闭 适合新手
#4,230 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
1/5
预计耗时
1 小时以内
新手友好度
88/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
冷清
技术栈
openapi
领域
api, documentation

调研方向

打开 docs/_static/auth/v2.yaml 中约第 188-189 行的位置,然后将凭据请求响应与约第 552 行和第 562 行的 RedirectResponse 和 RedirectResponseWithID schema 进行比较。确认文档中记录的响应与当前行为一致,并确保完成后的描述不再声称存在 session_id,因为被引用的 schema 不会返回该字段。

由索引模型根据 Issue 内容生成。

描述

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

主要语言
Go
星标
29
派生
24
平均合并
2 天 18 小时
30 天内合并 PR
45

环境准备

  • 提供 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

nuts-foundation/nuts-node 的其他 Issue

查看 nuts-foundation/nuts-node 的全部 Issue

相似的 Issue

更多 Go Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。