Authenticating API Requests

Updated 7 months ago ​by Jake Peters

The HelpDocs API has a flexible authentication scheme.

You can choose to provide your API key as an HTTP Bearer token, or pass it as a query parameter.

You must pass your token with every API request

For instance, using the popular Node.js request module, you could make a request using Bearer auth like this:

request.get('https://api.helpdocs.io/v1/category', {
  'auth': {
    'bearer': 'your-api-key'
  }
});

Or you could make the same request with your key as the key query parameter:

request.get('https://api.helpdocs.io/v1/category?key=your-api-key');
All requests to the API must be made via HTTPS to https://api.helpdocs.io/v1. The API is not available through your custom domain or your *.helpdocs.io subdomain

How did we do?