Javascript SDK for communicating with Ingest's REST API.
Last updated 3 years ago by sgillamwright .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @ingest/ingest-js-sdk 
SYNC missed versions from official npm registry.

Ingest.IO Javascript SDK

Build Status Greenkeeper badge

The official Ingest.IO Javascript SDK for interfacing with Ingest.

Getting Started

Getting started with the Ingest SDK is simple.

The Ingest JS SDK is fully promise based and uses pinkyswear to handle the promises, removing the need for any polyfills.

There are 2 main ways to utilize it.


  1. Install the SDK via npm:
npm install @ingest/ingest-js-sdk
  1. Require it in your project:
  var IngestSDK = require('@ingest/ingest-js-sdk');
  1. Initialize the SDK:
  var Ingest = new IngestSDK({
    token: 'Bearer ...'
  1. Start making calls:
    .then(function (response) {
      // Handle Response

Via Script

  1. Clone the repo
  2. Put the ingest-sdk.js in a hosted location
  3. Include the script tag in your HTML
  <script src="/path/to/hosted/files/ingest-sdk.js"></script>
  1. Initialize the SDK:
  var Ingest = new IngestSDK({
    token: 'Bearer ...'
  1. Start making calls:
    .then(function (response) {
      // Handle Response

Uploading a file

Uploading a file is slightly different then using the other resources. To upload a file and start the upload, grab your file and use the Ingest.upload functionality:

  upload = Ingest.upload(file);

The Ingest.upload function returns an upload object, with the following functions available:

Method Endpoint
abort Allows you to abort the upload.
abortSync Allows you to abort the upload synchronously. Takes a callback function to invoke when complete.
pause Pauses the upload.
progress Takes a callback function that is invoked anytime progress on the upload occurs.
resume Resumes a paused upload.
save Starts the upload.

API Documentation

For more information on the available functionality of the sdk, please see the API Docs.


If you encounter any issues using the Ingest JS SDK, please search the existing issues first before opening a new one.

Please include any information that may be of assistance with reproducing the issue.


To modify the source of the Ingest SDK, clone the repo.

npm install

Develop in a topic/feature branch, not master.

Running Tests

To run the unit tests, use:

npm run test

To watch the unit tests, use:

npm run test:watch


This SDK is distributed under the MIT License, see License for more information.

Current Tags

  • 2.3.1                                ...           latest (3 years ago)

8 Versions

  • 2.3.1                                ...           3 years ago
  • 2.3.0                                ...           3 years ago
  • 2.2.0                                ...           3 years ago
  • 2.1.0                                ...           3 years ago
  • 2.0.1                                ...           3 years ago
  • 2.0.0                                ...           3 years ago
  • 1.10.1                                ...           3 years ago
  • 1.10.0                                ...           3 years ago
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 8
Last Month 9
Dependencies (3)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |