Quickly and easily access any RESTful or RESTful-like API.

If you are looking for the SendGrid API client library, please see this repo.

Announcements

All updates to this library are documented in our CHANGELOG.

Table of Contents

• Installation
• Quick Start
• Usage
• Roadmap
• How to Contribute
• About
• License

Installation

Prerequisites

• Node.js version 0.10, 0.12 or 4

You need to have a API key to use the app. To configure the API key in the environment variables follow these steps.

• create .env file in the root directory of the project.
• Copy the contents of .env_sample file in to the .env file
• Once you have obtained the API key, find the environment variable SENDGRID_API_KEY and assign your API key as it's value. As an example it should look like this

SENDGRID_API_KEY='<YOUR_API_KEY>';

Install Package

1npm install sendgrid-rest

Quick Start

GET /your/api/{param}/call

1var Client = require('sendgrid-rest').Client
2var client = new Client()
3var request = client.emptyRequest()
4var param = 'myparam'
5request.host = 'api.example.com'
6request.method = 'GET'
7request.path = '/your/api/' + param + '/call'
8client.API(request, function (response) {
9  console.log(response.statusCode)
10  console.log(response.body)
11  console.log(response.headers)
12})

POST /your/api/{param}/call with headers, query parameters and a request body.

1var Client = require('sendgrid-rest').Client
2var client = new Client()
3var request = client.emptyRequest()
4request.host = 'api.example.com'
5request.headers['Authorization'] = 'Bearer XXXXXX'
6request.queryParams['limit'] = 100
7request.queryParams['offset'] = 0
8request.method = 'POST'
9var param = 'myparam'
10request.path = '/your/api/' + param + '/call'
11requestBody = {
12  'some': 0,
13  'awesome': 1,
14  'data': 3
15}
16request.body = requestBody
17client.API(request, function (response) {
18  console.log(response.statusCode)
19  console.log(response.body)
20  console.log(response.headers)
21})

Usage

Following is an example using SendGrid. You can get your free account here.

First, update your environment with your SENDGRID_API_KEY.

You can copy the .env_example file located in the "examples" folder to .env in your project's root.

cp examples/.env_sample .env

Once you have edited the file and added your API Key, you can add the variable to your environment: source .env

Here is the full working code.

To run the example:

1node examples/example

======= Library Usage Documentation

Tests

Tests can be run through a Docker container which is defined in the docker-compose.yml file.

To run the tests, simply run docker-compose up.

Roadmap

If you are interested in the future direction of this project, please take a look at our milestones. We would love to hear your feedback.

How to Contribute

We encourage contribution to our libraries, please see our CONTRIBUTING guide for details.

• Feature Request
• Bug Reports
• Improvements to the Codebase

About

nodejs-http-client is guided and supported by the SendGrid Developer Experience Team.

nodejs-http-client is maintained and funded by SendGrid, Inc. The names and logos for nodejs-http-client are trademarks of SendGrid, Inc.

License

The MIT License (MIT)