[Schema Inaccuracy] Example and schema mismatch at patch-schema

未关闭适合新手

#4,470 创建于 2025年1月26日 2 条评论 0 个 reaction 已指派 0 人在 GitHub 查看

还没有人认领这个 Issue。

评估

难度: 2/5
预计耗时: 1-3 小时
新手友好度: 65/100

Issue 类型: 缺陷
描述清晰度: 描述清楚
活跃度: 停滞
技术栈: json, openapi
领域: api

调研方向

打开 descriptions-next/ghes-3.13/ghes-3.13.json，并检查报告中给出的 schema 和 example 位置。将 patch operation 的 value 定义与 addMembers example 进行比较，更新其中一方使两者一致，并验证该 example 能够根据 schema 解析。

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

描述

documentation

Schema Inaccuracy

The schema at this location is

#/components/schemas/patch-schema/properties/Operations/items/properties/value

                "value": {
                  "type": "string",
                  "description": "Corresponding 'value' of that field specified by 'path'"
                }

The example at is

#/paths/~1scim~1v2~1enterprises~1{enterprise}~1Groups~1{scim_group_id}/patch/requestBody/content/application~1json/examples/addMembers/value

          {
            "Operations" : [ {
              "op" : "add",
              "path" : "members",
              "value" : [ {
                "value" : "879db59-3bdf-4490-ad68-ab880a2694745"
              }, {
                "value" : "0db508eb-91e2-46e4-809c-30dcbda0c685"
              } ]
            } ],
            "schemas" : [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ]
          }

The value cannot be parsed.

Expected

Either the example or schema is updated to match the other.

Reproduction Steps

This has been observed on

https://github.com/github/rest-api-description/raw/main/descriptions-next/ghes-3.13/ghes-3.13.json

I've checked for this in 3.10, 3.11, 3.12, 3.13, 3.14.

主要语言: 没有语言数据
星标: 1.6k
派生: 342
平均合并: 3 小时 33 分钟
30 天内合并 PR: 51

贡献指南

打开贡献指南

从这里开始

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

github/rest-api-description 的其他 Issue

[Schema Inaccuracy] Missing Link header from org/security-advisories response description 未关闭

feature

难度 2/5 1-3 小时新手友好度 82/100

github/rest-api-description#7201 · 2026年9月15日创建
Runner deprecations: enterprise scope is in the changelog and the 404 handler but not in the description 未关闭

feature

难度 2/5 1-3 小时新手友好度 72/100

github/rest-api-description#7163 · 2026年9月9日创建
Runner deprecations: registration_deprecates_at is declared on the response but never returned 未关闭

feature

难度 2/5 1-3 小时新手友好度 68/100

github/rest-api-description#7162 · 2026年9月9日创建
configure-pages API endpoint yields anchor that doesn't exist in docs 未关闭

feature

难度 2/5 1-3 小时新手友好度 68/100

github/rest-api-description#7135 · 2026年9月4日创建
Document RepositoryRole actor_id values for ruleset bypass_actors — critical security feature, currently undocumented 未关闭

feature

难度 2/5 1-3 小时新手友好度 74/100

github/rest-api-description#7111 · 1 条评论 · 2026年9月1日创建

查看 github/rest-api-description 的全部 Issue

相似的 Issue

[Bug]: Matrix progress drafts fail with "Matrix runtime not initialized" during tool activity 未关闭

bug clawsweeper:linked-pr-open clawsweeper:needs-live-repro clawsweeper:no-new-fix-pr impact:message-loss issue-rating: 🐚 platinum hermit P2 regression

难度 2/5 1-3 小时新手友好度 78/100

openclaw/openclaw#155298 · 2 条评论 · 1 个 reaction · 2026年9月22日创建
[Bug] NULL pointer dereference in llm_running_callback (NGZA-AX-LLM #3) 未关闭

难度 1/5 1 小时以内新手友好度 90/100

AXERA-TECH/ax-llm#77 · 2026年9月22日创建
resume() sends a second HTTP response (400) after a successful resume 未关闭

难度 1/5 1 小时以内新手友好度 90/100

games-on-whales/wolf#509 · 2026年9月21日创建
MCP client has no httpx timeout, so the event stream fails after 5 seconds 未关闭

难度 2/5 1-3 小时新手友好度 78/100

Azure/azure-functions-agents-runtime#228 · 2026年9月21日创建
feat(mcp): friendlier error when `run_cloud_sync` is called on a disabled connection 未关闭

enhancement

难度 2/5 1-3 小时新手友好度 72/100

airbytehq/PyAirbyte#1205 · 2026年9月21日创建

更多 Backend & API Design Issue