Convenience wrapper for `got` to interact with the GitHub API
JavaScript
Clone or download

readme.md

gh-got Build Status

Convenience wrapper for got to interact with the GitHub API

Install

$ npm install gh-got

Usage

Instead of:

const got = require('got');
const token = 'foo';

(async () => {
	const {body} = await got('https://api.github.com/users/sindresorhus', {
		json: true,
		headers: {
			'accept': 'application/vnd.github.v3+json',
			'authorization': `token ${token}`
		}
	});

	console.log(body.login);
	//=> 'sindresorhus'
})();

You can do:

const ghGot = require('gh-got');

(async () => {
	const {body} = await ghGot('users/sindresorhus', {token: 'foo'});

	console.log(body.login);
	//=> 'sindresorhus'
})();

Or:

const ghGot = require('gh-got');

(async () => {
	const {body} = await ghGot('https://api.github.com/users/sindresorhus', {token: 'foo'});

	console.log(body.login);
	//=> 'sindresorhus'
})();

API

Same as got (including the stream API and aliases), but with some additional options below.

Errors are improved by using the custom GitHub error messages. Doesn't apply to the stream API.

token

Type: string

GitHub access token.

Can be set globally with the GITHUB_TOKEN environment variable.

endpoint

Type: string
Default: https://api.github.com/

To support GitHub Enterprise.

Can be set globally with the GITHUB_ENDPOINT environment variable.

body

Type: Object

Can be specified as a plain object and will be serialized as JSON with the appropriate headers set.

License

MIT © Sindre Sorhus