Authorise GitHub API requests by appending the environments auth credentials to your request's query string.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
source
.editorconfig
.eslintrc.js
.gitignore
.npmignore
.travis.yml
CONTRIBUTING.md
HISTORY.md
LICENSE.md
README.md
example.js
package-lock.json
package.json

README.md

githubauthquerystring

Travis CI Build Status NPM version NPM downloads Dependency Status Dev Dependency Status
Patreon donate button Flattr donate button Liberapay donate button Thanks App donate button Boost Lab donate button Buy Me A Coffee donate button Open Collective donate button crypto donate button PayPal donate button Wishlist browse button

Authorise GitHub API requests by appending the environments auth credentials to your request's query string.

Install

NPM

  • Install: npm install --save githubauthquerystring
  • Module: require('githubauthquerystring')

Editions

This package is published with the following editions:

  • githubauthquerystring aliases githubauthquerystring/source/index.js
  • githubauthquerystring/source/index.js is esnext source code with require for modules

Older environments may need Babel's Polyfill or something similar.

Usage

Complete API Documentation.

Fetch

Use require('githubauthquerystring').fetch() to fetch the GitHub Auth Query String that you need to authorise your GitHub API request to avoid rate limits.

Using environment variables:

const githubAuthQueryString = require('githubauthquerystring').fetch()
const githubApiURL = `https://api.github.com/some/call?${githubAuthQueryString}`

Using manual GITHUB_ACCESS_TOKEN:

const githubAuthQueryString = require('githubauthquerystring').fetch({
    GITHUB_ACCESS_TOKEN: 'value'
})
const githubApiURL = `https://api.github.com/some/call?${githubAuthQueryString}`

Using manual GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET:

const githubAuthQueryString = require('githubauthquerystring').fetch({
    GITHUB_CLIENT_ID: 'value',
    GITHUB_CLIENT_SECRET: 'value'
})
const githubApiURL = `https://api.github.com/some/call?${githubAuthQueryString}`

If the values did not exist or were not in a valid combination, then an empty string will be returned.

Redaction

Use require('githubauthquerystring').redact(url) to redact the credentials from a URL for error handling and logging.

const {fetchGithubAuthQueryString, redactGithubAuthQueryString} = require('githubauthquerystring')

// fetch the url
const githubAuthQueryString = fetchGithubAuthQueryString({
    GITHUB_CLIENT_ID: 'value',
    GITHUB_CLIENT_SECRET: 'value'
})
const githubApiURL = `https://api.github.com/some/call?${githubAuthQueryString}`

// now redact it
const githubApiRedactedURL = redactGithubAuthQueryString(githubApiURL)

History

Discover the release history by heading on over to the HISTORY.md file.

Contribute

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

Backers

Maintainers

These amazing people are maintaining this project:

  • Benjamin Lupton

Sponsors

No sponsors yet! Will you be the first?

Patreon donate button Flattr donate button Liberapay donate button Thanks App donate button Boost Lab donate button Buy Me A Coffee donate button Open Collective donate button crypto donate button PayPal donate button Wishlist browse button

Contributors

These amazing people have contributed code to this project:

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

License

Unless stated otherwise all works are:

  • Copyright © 2018+ Benjamin Lupton

and licensed under: