Skip to main content

此版本的 GitHub Enterprise 已停止服务 2022-10-12. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

媒体类型

了解用于指定要使用的数据� �式的媒体类型。

自定义媒体类型在 API 中用于让使用者选择他们想要接收的数据� �式。 可在发出请求时将以下一种或多种类型添� 到 Accept � �头来实现此功能。 媒体类型特定于资源,允许它们独立更改并支持其他资源不支持的� �式。

所有 GitHub Enterprise Server 媒体类型如下所示:

application/vnd.github.param[+json]

API 支持的最基本媒体类型是:

application/vnd.github+json
application/json

注意:过去,我们建议在 Accept � �头中包含 v3。 现在不再需要此操作,对� 的 API 请求没有影响。

如果要指定属性(例如下面定义的 full/raw 等),请将它放在 github 之后:

application/vnd.github.raw+json

注释正文属性

注释正文可采用 GitHub Flavored Markdown � �式,问题问题注释拉取请求注释gist 注释 API 都接受这些相同的媒体类型:

原始

application/vnd.github.raw+json

返回原始 Markdown 正文。 响应将包括 body。 这是在不� 递任何特定媒体类型时的默认值。

文本

application/vnd.github.text+json

返回 Markdown 正文的纯文本表示形式。 响应将包括 body_text

HTML

application/vnd.github.html+json

返回从正文的 Markdown 中渲染的 HTML。 响应将包括 body_html

完全

application/vnd.github.full+json

返回 raw、text 和 HTML 表示形式。 响应将包括 bodybody_textbody_html

Git blob 属性

获取 Blob 时,可使用以下媒体类型:

JSON

application/vnd.github+json
application/json

返回 Blob 的 JSON 表示形式,content 为 base64 编� �的字符串。 这是在未� 递任何参数时的默认值。

原始

application/vnd.github.raw

返回原始 blob 数据。

提交、提交比较和拉取请求

提交 API拉取请求 API 支持 diffpatch � �式:

diff

application/vnd.github.diff

修补程序

application/vnd.github.patch

sha

application/vnd.github.sha

仓库内容

原始

application/vnd.github.raw

返回文件的原始内容。 这是在不� 递任何特定媒体类型时的默认值。

HTML

application/vnd.github.html

对于 Markdown 或 AsciiDoc 等� �记文件,可以使用 .html 媒体类型检索呈现的 HTML。 使用开源� �记库将� �记语言呈现给 HTML。

Gists

原始

application/vnd.github.raw

返回 gist 的原始内容。 这是在不� 递任何特定媒体类型时的默认值。

base64

application/vnd.github.base64

gist 内容在发送之前会进行 base64 编� �。这在 gist 包含任何� 效的 UTF-8 序列时非常有用。