onesky / api-documentation-platform

Documentation of platform API
60 stars 55 forks source link

OneSky Platform API

OneSky Platform API provides programmatic access to OneSky's platform management.

The new API

This is new Platform API and is not compatible with the Classic API. This new API covers most of the endpoints of classic API with numerous of new endpoints added and will continue to be actively developed going forward.

Authentication

All of the endpoints require you to authenticate. You will have to find your own API key and API secret. First login to OneSky and find the API key.

API Access

This Platform API is available for organizations subscribed to STARTER or above plans.

Parameters

Name Type Description
api_key string Your own API public key
timestamp integer Current unix timestamp (GMT+0) in seconds
dev_hash string Calculate with timestamp and api_secret
Formula: md5(concatenate(<timestamp>, <api_secret>))

Request

We accept request data in JSON format. Please specify request header with content-type: application/json and encode the data in JSON format.

SSL is applied to protect all request data. Make sure you are using https to initiate request.

Response

Response body will be in JSON format with 2 objects.

Currently, we only support JSON data format in response.

Success

Successful request will response with 2xx status code together with response body if there is. Details of response body is shown at the bottom of each endpoints.

Failure

Failure request will response with an error status code together with an error message.

Example:

status 400 bad request
{
  "meta": {
    "status": 400,
    "message": "Your request cannot be processed"
  },
  "data": {}
}

For more authentication error troubleshooting, please see this article.

Resources

Project

String

Order

Language

Wrappers

PHP

PHP Symphony

Python

Ruby

Rails

Grunt

Node.js

Go

C#

.NET

Elixir