NAV
javascript ruby python java obj-c

Introduction

Welcome to the Krakenize API! You can use our API to access Kraken API endpoints.

Krakenize focused on delivering best and most reliable source for their applications that will not only keep data, but also secure it and offer other possibilities to ease life of mobile developers.

We have language bindings in Javascript, Ruby, Python, Java and Obj-c! You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.

Authentication

To authorize, use this code:

var api = $kdb.authorize('APIKEY')
require 'kdb'

api = Kdb::APIClient.authorize!('APIKEY')
import kdb

api = kdb.authorize('APIKEY')
Kdb api = new Kdb;
api.authorize("APIKEY")

Make sure to replace APIKEY with your API key.

Krakenize uses API keys to allow access to the API. You can register a new Krakenize API key at our developer portal.

Krakenize expects for the API key to be included in all API requests to the server in a header that looks like the following:

Authorization: APIKEY

REST API

Get All

var api = $kdb.authorize('APIKEY')
require 'kdb'

api = Kdb::APIClient.authorize!('APIKEY')
import kdb

api = kdb.authorize('APIKEY')
Kdb api = new Kdb;
api.authorize("APIKEY")

The above command returns JSON structured like this:

[
  {
    "_id": "54b61de93d9099c57c9eef54",
    "name": "Tesla",
    "__v": 0
  },
  {
    "_id": "54ba85166dce35371936773f",
    "name": "BMW",
    "__v": 0
  },
  {
    "_id": "54ba8ff6984c93b12891ddb2",
    "name": "Alfa",
    "__v": 0
  }
]

This endpoint retrieves all kittens.

HTTP Request

GET http://krakenize.io/api/1/{appname}/{tablename}

Query Parameters

Parameter Type Description
appname String Your App Name
tablename String Name of table you want to access

Get a Specific

var api = $kdb.authorize('APIKEY')
require 'kdb'

api = Kdb::APIClient.authorize!('APIKEY')
import kdb

api = kdb.authorize('APIKEY')
Kdb api = new Kdb;
api.authorize("APIKEY")

The above command returns JSON structured like this:

[
  {
    "_id": "54ba85166dce35371936773f",
    "name": "BMW",
    "__v": 0
  }
]

This endpoint retrieves a specific object.

HTTP Request

GET http://krakenize.io/api/1/{appname}/{tablename}/{objectId}

URL Parameters

Parameter Description
objectId The ID of the Object to retrieve

Creating Objects

var api = $kdb.authorize('APIKEY')
require 'kdb'

api = Kdb::APIClient.authorize!('APIKEY')
import kdb

api = kdb.authorize('APIKEY')
Kdb api = new Kdb;
api.authorize("APIKEY")

The above command returns JSON structured like this:

{
  "status": "OK"
}

This endpoint creates object.

HTTP Request

POST http://krakenize.io/api/1/{appname}/{tablename}

URL Parameters

Parameter Description
username should look like {username}@{appname}
password password of user

Delete a Specific object

var api = $kdb.authorize('APIKEY')
require 'kdb'

api = Kdb::APIClient.authorize!('APIKEY')
import kdb

api = kdb.authorize('APIKEY')
Kdb api = new Kdb;
api.authorize("APIKEY")

The above command returns JSON structured like this:

{
  "status": "OK"
}

This endpoint retrieves a specific object.

HTTP Request

DELETE http://krakenize.io/api/1/{appname}/{tablename}/{objectId}

URL Parameters

Parameter Description
objectId The ID of the Object to delete

Update a Specific object

var api = $kdb.authorize('APIKEY')
require 'kdb'

api = Kdb::APIClient.authorize!('APIKEY')
import kdb

api = kdb.authorize('APIKEY')
Kdb api = new Kdb;
api.authorize("APIKEY")

The above command returns JSON structured like this:

{
  "status": "OK"
}

This endpoint retrieves a specific object.

HTTP Request

PUT http://krakenize.io/api/1/{appname}/{tablename}/{objectId}

URL Parameters

Parameter Description
objectId The ID of the Object to update

Errors

The Krakenize API uses the following error codes:

Error Code Meaning
400 Bad Request – Your request sucks
401 Unauthorized – Your API key is wrong
403 Forbidden – The kitten requested is hidden for administrators only
404 Not Found – The specified kitten could not be found
405 Method Not Allowed – You tried to access a kitten with an invalid method
406 Not Acceptable – You requested a format that isn’t json
410 Gone – The kitten requested has been removed from our servers
418 I’m a teapot
429 Too Many Requests – You’re requesting too many kittens! Slown down!
500 Internal Server Error – We had a problem with our server. Try again later.
503 Service Unavailable – We’re temporarially offline for maintanance. Please try again later.