Настраиваемые типы мультимедиа используются в API, чтобы потребители могли выбирать формат данных, которые они хотят получить. Это делается путем добавления следующих типов (одного или нескольких) в заголовок Accept
при создании запроса. Типы мультимедиа связаны с конкретными ресурсами, что позволяет изменять их независимо друг от друга и обеспечить поддержку форматов, которые не поддерживают другие ресурсы.
Все типы мультимедиа GitHub Enterprise Server выглядят следующим образом:
application/vnd.github.param[+json]
Основные типы мультимедиа, поддерживаемые API:
application/vnd.github+json
application/json
Примечание. В прошлом мы рекомендовали включить v3
в заголовок Accept
. Это больше не требуется и не повлияет на запросы API.
Если вы указываете свойство (например, full, raw и т. п.), поместите его после github
:
application/vnd.github.raw+json
Свойства текста комментария
Текст комментария можно записать в GitHub Flavored Markdown. API для управления проблемами, примечаний к выдаче, комментариев к запросу на вытягивание и комментариев gist принимают те же типы мультимедиа:
Необработанный тип мультимедиа для свойств текста комментария
application/vnd.github.raw+json
Возвращает необработанный текст в разметке Markdown. Ответ будет включать body
. Используется по умолчанию, если вы не передаете определенный тип мультимедиа.
Тип текстового носителя для свойств текста примечания
application/vnd.github.text+json
Возвращает только текстовое представление разметки Markdown. Ответ будет включать body_text
.
Тип мультимедиа HTML для свойств текста примечания
application/vnd.github.html+json
Возвращает HTML-представление, преобразованное из разметки Markdown. Ответ будет включать body_html
.
Полный тип носителя для свойств текста примечания
application/vnd.github.full+json
Возвращает представления в виде необработанных данных, текста и HTML. Ответ будет включать body
, body_text
и body_html
.
Свойства BLOB-объекта Git
При получении BLOB-объекта разрешены следующие типы мультимедиа.
Тип мультимедиа JSON для свойств BLOB-объекта Git
application/vnd.github+json
application/json
Возвращает JSON-представление BLOB-объекта с content
в виде строки в кодировке base64. Используется по умолчанию, если ничего не передается.
Необработанный тип мультимедиа для свойств BLOB-объекта Git
application/vnd.github.raw
Возвращает необработанные данные BLOB-объекта.
Фиксации, сравнение фиксаций и запросы на вытягивание
REST API для управления фиксациями и запросами на вытягивание поддерживает форматы различий и исправлений :
разливание типа носителя для фиксаций, сравнения фиксаций и запросов на вытягивание
application/vnd.github.diff
Тип носителя patch для фиксаций, сравнения фиксаций и запросов на вытягивание
application/vnd.github.patch
Тип носителя sha для фиксаций, сравнения фиксаций и запросов на вытягивание
application/vnd.github.sha
Содержимое репозитория
Необработанный тип носителя для содержимого репозитория
application/vnd.github.raw
Возвращает необработанное содержимое файла. Используется по умолчанию, если вы не передаете определенный тип мультимедиа.
Тип мультимедиа HTML для содержимого репозитория
application/vnd.github.html
Для файлов разметки, таких как Markdown или AsciiDoc, можно получить отрисованный HTML-код с помощью типа мультимедиа .html
. Языки разметки отрисовываются в HTML с помощью библиотеки разметки с открытым кодом.
Gist
Необработанный тип мультимедиа для gist
application/vnd.github.raw
Возвращает необработанное содержимое gist. Используется по умолчанию, если вы не передаете определенный тип мультимедиа.
Тип носителя Base64 для gist
application/vnd.github.base64
Перед отправкой содержимое gist шифруется в кодировке Base64. Это может быть полезно, если gist содержит недопустимые последовательности UTF-8.