[Feature Request] Standardize operationIds to ensure uniqueness

未关闭

#361 创建于 2023年3月24日 3 条评论 0 个 reaction 已指派 0 人在 GitHub 查看

还没有人认领这个 Issue。

评估

难度: 4/5
预计耗时: 3-5 天
新手友好度: 35/100

Issue 类型: 功能
描述清晰度: 基本清楚
活跃度: 停滞
技术栈: csharp, powershell
领域: api, tooling

调研方向

从引用的 OpenAPIService/PowershellFormatter.cs 和 pull request 338 中链接的讨论开始，以了解现有的 operationId 约定。跟踪 OData 路径的 operationIds 在哪里生成，然后确定文档验证入口；完成的标准是应用所请求的命名规则，并拒绝重复的 operationIds。

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

描述

priority:p3 type:enhancement

We should consider standardizing the naming convention of operationIds to what we currently have in DevX API (PowerShell style) - https://github.com/microsoftgraph/microsoft-graph-devx-api/blob/dev/OpenAPIService/PowershellFormatter.cs? For example:

Remove hash suffix values from operationIds for ~~function~~ all paths.
Add '_' to separate verb (action) in an operationId. This typically the last . or second from last . for OData cast paths.
PUT operations should have Set as the verb in an operationId {xxx}_Set{yyy}.

In PowerShell, we use operationIds to form command names.

As part of this exercise, we should add validation to ensure operationIds are unique for a given document.

Edit: This is a continuation of https://github.com/microsoft/OpenAPI.NET.OData/pull/338#discussion_r1097802458.

主要语言: C#
星标: 240
派生: 70
平均合并: 7 小时 59 分钟
30 天内合并 PR: 13

贡献指南

打开贡献指南

从这里开始

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

microsoft/OpenAPI.NET.OData 的其他 Issue

IEdmModel.ConvertToOpenApi() throws System.InvalidOperationException when having dollar-count similar path in controller 未关闭

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

microsoft/OpenAPI.NET.OData#661 · 2025年2月14日创建
Microsoft.OpenApi.OData.Reader.dll ships unversioned (0.0.0.0) since the 2026-01-16 releases 未关闭

难度 3/5 1-2 天新手友好度 58/100

microsoft/OpenAPI.NET.OData#852 · 2026年8月4日创建
Microsoft.OData.Edm 9.0.0-rc compat: MissingMethodException on ExtensionMethods.GetReturn(IEdmOperation) 未关闭

难度 4/5 3-5 天新手友好度 45/100

microsoft/OpenAPI.NET.OData#833 · 2026年6月18日创建
Provide a way to not generate navigation paths with key 未关闭

status:needs-more-information

难度 4/5 3-5 天新手友好度 42/100

microsoft/OpenAPI.NET.OData#723 · 1 条评论 · 1 个 reaction · 2025年7月29日创建
Action bound to abstract entity type is not present in OpenAPI output when using hidi to convert from CSDL 未关闭

难度 3/5 1-2 天新手友好度 45/100

microsoft/OpenAPI.NET.OData#720 · 2025年7月10日创建

查看 microsoft/OpenAPI.NET.OData 的全部 Issue

相似的 Issue

Hold Marten and JasperFx bumps on 4.x after 9.38 未关闭

core dependencies

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

BaryoDev/barakoCMS#1001 · 2026年9月24日创建
Cleared mission history filter returns after navigating away 未关闭

bug frontend good first issue

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

equinor/flotilla#3019 · 2026年9月24日创建
NavigationViewItemAutomationPeer implements IInvokeProvider but never advertises the Invoke pattern 未关闭

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

unoplatform/uno#24629 · 2026年9月24日创建
[fix] Add NO_COLOR and redirected-output support to console color output 未关闭

agentic-workflows Needs: Triage :mag: State: In-PR

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

microsoft/vstest#16517 · 2026年9月24日创建
SPANISH indexers that are offline due to the Soccer Spanish WEB blackout 未关闭

Down / Waiting for removal

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

Jackett/Jackett#17085 · 2026年9月24日创建

更多 C# Issue

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