[Schema Inaccuracy] `GET /repos/{owner}/{repo}/contents/{path}` spec is missing raw+json / html+json response media types

オープン

#6,089 2026年3月7日に作成コメント 0 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 2/5
見積もり時間: 1〜3時間
初心者へのやさしさ: 45/100

issue の種類: バグ
明瞭さ: 明確に書かれている
活発さ: 停滞
技術スタック: openapi
領域: api

調査の方向性

まず GET /repos/{owner}/{repo}/contents/{path} の OpenAPI 定義を見つけ、リンク先の REST API ドキュメントとその 200 レスポンスを比較します。fpt、ghec、ghes-* のすべてのバリアントに、issue に示されているスキーマを使用した raw+json および html+json メディアタイプを追加し、その後、エンドポイント定義に一貫性があることを確認します。

索引モデルが issue の本文から書いたものです。

説明

documentation

Schema Inaccuracy

The Get repository content docs list these custom media types for that path, but the structured schema doesn't have them:

application/vnd.github.raw+json – Returns the raw file contents for files and symlinks.
application/vnd.github.html+json – Returns the file contents in HTML (e.g. via GitHub's Markup library).

The description currently only includes application/json and application/vnd.github.object for the 200 response.

Expected

{
  "paths": {
    "/repos/{owner}/{repo}/contents/{path}": {
      "get": {
        "responses": {
          "200": {
            "content": {
              "application/json": { "...": "..." },
              "application/vnd.github.object": { "...": "..." },
              "application/vnd.github.raw+json": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/vnd.github.html+json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}

Reproduction Steps

This applies to all variants:

fpt
ghec
ghes-*

主要言語: 言語のデータがありません
スター: 1.6k
フォーク: 342
平均マージ: 3時間 33分
マージ済み PR（30日）: 51

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
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]: session_search misses a short non-Latin query typed in the other case オープン

難易度 2/5 1〜3時間初心者へのやさしさ 78/100

use-agent-os/agent-os#3312 · 2026年9月22日に作成
[control_panel] uninstall 专用的 Agent 绑定守卫被误用于 start/stop/restart，导致被 Agent 绑定的 App 无法停止オープン

難易度 2/5 1〜3時間初心者へのやさしさ 85/100

buckyos/buckyos#626 · 2026年9月22日に作成
[Bug] Hybrid search panics or truncates results for non-positive topK オープン

needs-acceptance wg/data-plane-networking

難易度 2/5 1〜3時間初心者へのやさしさ 78/100

vllm-project/semantic-router#4024 · コメント 1 件 · 2026年9月22日に作成
Very long search text gives a bare "Error: Failed to fetch" オープン

bug good first issue

難易度 2/5 1〜3時間初心者へのやさしさ 88/100

amponce/archive-movie-browser#165 · 2026年9月22日に作成
math/big: Rat.GobDecode accepts negative zero オープン

難易度 2/5 1〜3時間初心者へのやさしさ 78/100

golang/go#81645 · コメント 1 件 · 2026年9月22日に作成

Backend & API Design の issue をもっと見る