Developers

To connect to Big Sky, you will need your user API token, which you can find on your Settings page.

This token needs to be set as a header with each request. For example, if you're using jQuery:

var token = 'abc1234' // Use your token here.

$.ajaxSetup({
  beforeSend: function(xhr) {
    return xhr.setRequestHeader("Authorization", "Token " + token);
  }
});

You can then make requests to the API, for example:

// List all maps
$.getJSON('//bigsky.io/api/maps', function(data) {
  console.log(data.maps); // [{ name: "Untitled map", ... }, ...]
});

// Create new map from CSV
$.ajax({
  type: "POST",
  url: "//bigsky.io/api/maps/create_from_csv",
  data: {
    csv_file_url: "http://netengine-assets.s3.amazonaws.com/numbers.csv"
  },
  success: function(data) {
    console.log("New map url: " + data.url)
  }
});

API Endpoints