OpenAPI: /request-credential description mentions session_id but schema doesn't return it
维护者通常 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.yamlaround line 188-189 RedirectResponseschema:docs/_static/auth/v2.yaml:552RedirectResponseWithIDschema:docs/_static/auth/v2.yaml:562
Fix options
Either:
- Update the description to drop the
session_idmention (if no correlation ID is actually needed for this flow), or - Change the response schema to
RedirectResponseWithIDand have the implementation return asession_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 模板
- 没有贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
nuts-foundation/nuts-node 的其他 Issue
-
bug
难度 2/5 1-3 小时 新手友好度 72/100
nuts-foundation/nuts-node#4450 ·
维护者通常 1 天内回复
-
bug discuss
难度 1/5 1 小时以内 新手友好度 88/100
nuts-foundation/nuts-node#4436 ·
维护者通常 1 天内回复
-
auth bug
难度 2/5 1-3 小时 新手友好度 82/100
nuts-foundation/nuts-node#4435 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 72/100
nuts-foundation/nuts-node#4321 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
nuts-foundation/nuts-node#4223 ·
维护者通常 1 天内回复
查看 nuts-foundation/nuts-node 的全部 Issue
相似的 Issue
-
难度 1/5 1 小时以内 新手友好度 72/100
slavakurilyak/awesome-ai-agents#845 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 3 天内回复
-
难度 2/5 1-3 小时 新手友好度 85/100
-
难度 2/5 1-3 小时 新手友好度 74/100
JakeChampion/lang#13132 ·
维护者通常 1 天内回复
-
[BUG] deploy.restart_policy without condition drops the restart policy可能已有人在做 @akshat-lakhera 今天认领。 未关闭
难度 2/5 1-3 小时 新手友好度 82/100
docker/compose#14383 · 1 条评论 ·
维护者通常 1 天内回复