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

[Schema Inaccuracy] Example and schema mismatch for `#/paths/~1manage~1v1~1maintenance/get`

未关闭
#5,547 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
35/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
停滞
技术栈
openapi
领域
api

调研方向

定位 GET /manage/v1/maintenance 的 OpenAPI schema 以及所引用的组件示例 #/components/examples/ghes-get-maintenance/value。在受影响的 GHES 描述中比较 scheduled_time schema 与示例。schema 和示例使用匹配的日期格式即表示完成。

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

描述

feature

Schema Inaccuracy

This is the json ref for the example

#/components/examples/ghes-get-maintenance/value

Schema and example mismatch. The schema says scheduled_time is a string with format date. But the example has what looks like a date-time.

Here's a snippet

    1: [ {
    2:   "hostname" : "ghe-local-primary",
    3:   "uuid" : "1b6cf518-f97c-11ed-8544-061d81f7eedb",
    4:   "status" : "scheduled",
>   5:   "scheduled_time" : "2006-01-02T15:04:05+00:00",
    6:   "connection_services" : [ {
    7:     "name" : "git operations",
    8:     "number" : 15
    9:   }, {

Expected

The schema and example are in sync

Reproduction Steps

I could reproduce this in

  • ghes-3.14
  • ghes-3.15
  • ghes-3.16
  • ghes-3.17
  • ghes-3.18
主要语言
没有语言数据
星标
1.6k
派生
342
平均合并
2 小时 23 分钟
30 天内合并 PR
57

贡献指南

打开贡献指南

从这里开始

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

github/rest-api-description 的其他 Issue

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

相似的 Issue

更多 Backend & API Design Issue

把新 issue 发到你的邮箱

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