shopify-api

shopify-api v0.1.0-alpha

shopify-api is a node library for working with the Shopify API. It is designed to abstract away requests while returning unmodified responses. It should be used as a building block for other modules/packages which can handle any additional abstraction needed based on the API resource that they are working with.

Install

npm install shopify-api --save

You can also use npm install https://github.com/ctalkington/node-shopify-api/archive/master.tar.gz to test upcoming versions.

Usage

This module is meant to be wrapped internally by other modules and therefore lacks any frontend interface.

Every resource is accessed via your shopify instance:

var shopify = require('shopify-api')(options);
// shopify.{ RESOURCE_NAME }.{ METHOD_NAME }

Every resource method accepts an optional callback as the last argument:

shopify.asset.create(
  { key: '...', value: '...' },
  function(err, asset) {
    if (err) {
      throw err;
    }
    console.log(asset);
  }
);

Additionally, every resource method returns a promise, so you don't have to use the regular callback. E.g.

shopify.asset.create({
  key: '...',
  value: '...'
}).then(function(customer) {
  // do something
}, function(err) {
  // Deal with an error
});

Instance Options

auth

The auth for requests to use.

This must be set either via option or setter method.

host

The host for requests to use.

This must be set either via option or setter method.

port

The port for requests to use. Default: 443

timeout

The time in ms to wait for requests before timing out. Default: 120000ms (2 minutes)

Instance Methods

setAuth()

Sets the internal auth property.

setHost(host[, port])

Sets the internal host/port properties.

setPort()

Sets the internal port property.

setTimeout()

Sets the internal timeout property.

Resources

The resources that are currently supported by this library. Please submit PR if your need others.

asset

create(themeid, props)

destroy(themeid, key)

list(themeid)

retrieve(themeid, key)

update(themeid, props)

theme

create(props)

destroy(id)

list()

retrieve(id)

update(id, props)

Things of Interest

• Changelog
• Contributing
• MIT License

Credits

Structured after the stripe package.