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
Remarque : dans le passé, nous vous recommandons d’inclure v3
dans votre en-tête Accept
. Cela n’est plus nécessaire et n’aura aucun impact sur vos demandes d’API.
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.