Hacktoberfest 2026:維護者為十月標記出來的 issue,仍然開放、適合新手。 瀏覽 Hacktoberfest issue

Consolidated $ref-to-Some Object feature request

未關閉
#3,853 8 則留言 7 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 1 天內回覆

還沒有人認領這個 Issue。

評估

難度
5/5
預估耗時
一週以上
新手友好度
35/100
Issue 類型
功能
描述清晰度
基本清楚
活躍度
冷清
技術堆疊
openapi
領域
api

研究方向

首先檢視與 Security Requirement、Security Scheme、Server、Tags、Operation、Media Type、Contact 和 License 相關的已連結 issue,以了解各自的使用情境與替代方案。定義支援這些物件使用 $ref 所需的規格變更,包括所指出對 operationId 的影響;當相關案例在 OpenAPI Specification 中得到一致解決時,即視為完成。

由索引模型根據 Issue 內容生成。

描述

re-use: ref-everywhere

This issure consolidates and replaces the numerous "can the OAS allow $ref for..." issues:

  • Security Requirement: OAI/OpenAPI-Specification#1850
  • Security Scheme: OAI/OpenAPI-Specification#1972 (but see also OAI/OpenAPI-Specification#3776 for an alternative)
  • Server: OAI/OpenAPI-Specification#2338
  • Tags: OAI/OpenAPI-Specification#2905
  • Operation: OAI/OpenAPI-Specification#2922 (but note that there are impacts on finding and resolving operationId)
  • Media Type: OAI/OpenAPI-Specification#3056 (closed because the specific use case is handled by overriding description with a Reference Object); also OAI/OpenAPI-Specification#2845 although there is more to that one)
  • Contact: OAI/OpenAPI-Specification#3552
  • License: OAI/OpenAPI-Specification#3569
主要語言
Markdown
星號
31.3k
分支
9.1k
平均合併
2 天 3 小時
30 天內合併 PR
8

環境準備

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

OAI/OpenAPI-Specification 的其他 Issue

查看 OAI/OpenAPI-Specification 的全部 Issue

相似的 Issue

更多 Backend & API Design Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。