Skip to main content

Tipos de mídia

Aprenda sobre os tipos de mídia para especificar o formato dos dados que você deseja consumir.

Tipos de mídia personalizados são usados na API para permitir que os consumidores escolham o formato dos dados que desejam receber. Faça isso adicionando um ou mais dos tipos a seguir ao cabeçalho Accept quando fizer uma solicitação. Os tipos de mídia são específicos aos recursos, permitindo que eles mudem de forma independente e ofereçam suporte a formatos que outros recursos não.

Todos os tipos de mídia de GitHub Enterprise Cloud se parecem com isto:

application/vnd.github.param[+json]

Os tipos mais básicos de mídia que a API suporta são:

application/vnd.github+json
application/json

Observação: no passado, recomendávamos incluir v3 em seu cabeçalho Accept. Isso não é mais necessário e não afetará suas solicitações de API.

Se você estiver especificando uma propriedade (como full/raw/etc., definida abaixo), coloque-a depois de github:

application/vnd.github.raw+json

Propriedades do texto do comentário

O corpo de um comentário pode ser escrito em GitHub Flavored Markdown, problemas, comentários sobre problemas, comentários sobre solicitações de pull, e as APIs de comentários sobre gists aceitam esses mesmos tipos de mídia:

Raw

application/vnd.github.raw+json

Retorna o texto do markdown sem processar. A resposta incluirá body. Este é o padrão se você não passar nenhum tipo de mídia específico.

Texto

application/vnd.github.text+json

Retorna uma representação única do texto do markdown. A resposta incluirá body_text.

HTML

application/vnd.github.html+json

Retorna um HTML interpretado a partir do markdown do texto. A resposta incluirá body_html.

Completo

application/vnd.github.full+json

Retorna as representações de HTML e texto sem processar. A resposta incluirá body, body_text e body_html:

Propriedades do Git blob

Os seguintes tipos de mídia são permitidos quando um blob é obtido:

JSON

application/vnd.github+json
application/json

Retorne a representação JSON do blob com content como uma cadeia de caracteres codificada em Base64. Este é o padrão, caso nada seja passado.

Raw

application/vnd.github.raw

Retorna os dados do blob sem processamento.

Commits, comparação de commit e pull requests

A API de commits e a API de solicitações de pull dão suporte aos formatos diff e patch:

diff

application/vnd.github.diff

patch

application/vnd.github.patch

sha

application/vnd.github.sha

Conteúdo do repositório

Raw

application/vnd.github.raw

Retorna o conteúdo sem processamento de um arquivo. Este é o padrão se você não passar nenhum tipo de mídia específico.

HTML

application/vnd.github.html

Para arquivos de marcação como Markdown ou AsciiDoc, recupere o HTML renderizado usando o tipo de mídia .html. As linguagens de marcação são renderizadas em HTML com nossa biblioteca Markup de código aberto.

Gists

Raw

application/vnd.github.raw

Retorna o conteúdo sem processar de um gist. Este é o padrão se você não passar nenhum tipo de mídia específico.

base64

application/vnd.github.base64

O conteúdo do gist é codificado em Base64 antes de ser enviado. Isso pode ser útil se o gist contém sequências UTF-8 inválidas.