This page will help you get started with Velodrome. You'll be up and running in a jiffy!
Install
npm install velodrome
API Key
API keys can be requested by emailing [email protected].
API Documentation
General API documentation is available on our developer portal at https://velodrome.readme.io/.
Authentication
The Velodrome API utilises HTTP Basic Auth for authentication. Each user is issued with a public and private API key. The public key is used as the Basic Auth Username and the private key is used as the Basic Auth Password. Every request is completed over SSL and HTTP Strict Transport Security (HSTS) is enforced.
General Info
This API library is based on mikeal's request library. As such each API request calls the callback provided with three parameters (error, resource, data) as in the node-request library. More info can be found in the request library documentation.
API keys are required for all requests.
Velodrome is currently only available in selected cities and orders can only be placed in Dublin, Ireland.
Usage
Include and initialise the library like so:
var velodrome = require("velodrome");
var api = new velodrome("YOUR_PUBLIC_KEY", "YOUR_PRIVATE_KEY");
List Cities Example
The following example shows how the Velodrome Node.js module could be used to list all cities Velodrome is available in.
var velodrome = require("velodrome");
var api = new velodrome("YOUR_PUBLIC_KEY", "YOUR_PRIVATE_KEY");
api.listCities(function (error, resource, data) {
if (error) {
throw error;
} else {
// data contains all the cities in a JS object
console.log(data);
}
});