API documentation for The Grid
Branch: master
Clone or download
Latest commit d59dfcd Feb 7, 2017

README.md

The Grid API documentation

Documentation for the public APIs of The Grid.

The latest built version is at developer.thegrid.io

For corrections, improvements file issues or pull requests in the the-grid/apidocs on Github.

Commandline tools

Several code examples are available as command-line tools, and can be useful for scripting, testing or development. You will need to have node.js installed.

To install

npm install -g thegrid-apidocs

Examples:

thegrid-authenticate             # get a The Grid user token, for use with the other tools

thegrid-share-file myfile.jpg    # share a file on disk to The Grid
thegrid-share-url http://coolblog.org/nifty.html                 # share article
thegrid-share-url http://myoldsite.com/article.html nocompress   # import all content of URL

thegrid-site-configure http://mygridsite.com colors   # show site config (here for colors)
thegrid-site-configure http://mygridsite.com name "My new name"   # set site config (here website title)

Schemas

In addition to the human-readable documentation, a set of JSON Schemas are provided. These can can be used to validate payloads, generate test-cases etc.

You can install or depend on these using NPM

npm install thegrid-apidocs

JavaScript validation example (using tv4 library)

var tv4 = require('tv4');
var apidocs = require('thegrid-apidocs');

var myPost = ....
var postSchema = apidocs.getSchema('item');
var valid = tv4.validate(myPost, postSchema);

Blueprints

The descriptions of HTTP APIs are using Blueprint found in ./blueprint. These are human-readable but can also be used to set up mock servers etc using the various tools that consume Blueprint.

Tests & examples

The schemas are tested for correctness using data-driven tests. Each of the valid and invalid ./examples, creates a testcase which ensures that the schema classifies it correctly.

The same examples are referenced in the Blueprint docs.