Types de médias

L’API utilise des types médias personnalisés pour permettre aux consommateurs de choisir le format des données qu’ils souhaitent recevoir. Pour ce faire, ajoutez un ou plusieurs types suivants à l’en-tête Accept lorsque vous effectuez une requête. Les types médias sont spécifiques aux ressources, ce qui leur permet de changer de façon indépendante et de prendre en charge des formats que d’autres ressources ne prennent pas en charge.

Tous les types de médias GitHub Enterprise Server ressemblent à ceci :

application/vnd.github.param[+json]

Les types multimédias les plus simples pris en charge par l’API sont les suivants :

application/vnd.github+json
application/json

Si vous spécifiez une propriété (comme complet/brut/etc. ci-dessous), placez la après github :

application/vnd.github.raw+json

Propriétés du corps du commentaire

Le corps d’un commentaire peut être écrit dans GitHub Flavored Markdown. Les API permettant de gérer les problèmes, les commentaires relatifs aux problèmes, les commentaires relatifs aux demandes de tirage (pull request) et les commentaires gist acceptent toutes les types de médias suivants :

Type de média brut pour les propriétés du corps de commentaire

application/vnd.github.raw+json

Retournez le corps Markdown brut. La réponse inclut body. Il s’agit de la valeur par défaut si vous ne transmettez aucun type de média spécifique.

Type de support texte pour les propriétés du corps de commentaire

application/vnd.github.text+json

Retourne une représentation de texte uniquement du corps Markdown. La réponse inclut body_text.

Type de média HTML pour les propriétés du corps de commentaire

application/vnd.github.html+json

Retournez le code HTML rendu à partir du Markdown du corps. La réponse inclut body_html.

Type de média complet pour les propriétés du corps de commentaire

application/vnd.github.full+json

Retournez des représentations brutes, textuelles et HTML. La réponse inclut body, body_text et body_html :

Propriétés d’objet blob Git

Les types multimédias suivants sont autorisés lors de l’obtention d’un objet blob :

Type de média JSON pour les propriétés d’objet blob Git

application/vnd.github+json
application/json

Retourne la représentation JSON de l’objet blob avec content comme chaîne encodée en base64. Il s’agit de la valeur par défaut si rien n’est passé.

Type de média brut pour les propriétés d’objet blob Git

application/vnd.github.raw

Retournez les données brutes de l’objet blob.

Validations, comparaison des validations et demandes de tirage

L’API REST permettant de gérer les commits et les demandes de tirage prennent en charge les formats diff et patch :

Type de média différentiel pour les commits, la comparaison de commits et les demandes de tirage

application/vnd.github.diff

Type de média correctif pour les commits, la comparaison de commits et les demandes de tirage

application/vnd.github.patch

Type de média SHA pour les commits, la comparaison de commits et les demandes de tirage

application/vnd.github.sha

Contenu d’un dépôt

Type de média brut pour le contenu du dépôt

application/vnd.github.raw

Renvoie le contenu brut d’un fichier. Il s’agit de la valeur par défaut si vous ne transmettez aucun type de média spécifique.

Type de média HTML pour le contenu du dépôt

application/vnd.github.html

Pour les fichiers de balisage, comme Markdown ou AsciiDoc, vous pouvez récupérer le code HTML rendu à l’aide du type de média .html. Les langages de balisage sont rendus au format HTML à l’aide de notre bibliothèque de balisage open source.

Gists

Type de média brut pour gists

application/vnd.github.raw

Retournez le contenu brut d’un gist. Il s’agit de la valeur par défaut si vous ne transmettez aucun type de média spécifique.

Type de média base64 pour les gists

application/vnd.github.base64

Le contenu du gist est encodé en base64 avant d’être envoyé. Cela peut être utile si votre gist contient des séquences UTF-8 non valides.