Kali-Server

Kali-Server provides a RESTful API centralizing SKU allocation and management for web-applications.

• kali-client The official Symfony bundle kali client
• API doc
• Commands

Summary

• Install
• Generate a Client
• Root Endpoint
• HTTP Verbs
• Authentication
  • Request token - Returned JSON
  • Use token to fetch API - Request route - Headers parameters - CLI example

Overview

Root Endpoint

API

"https://{projectDomain}/api"

API Doc

"https://{projectDomain}/doc"

HTTP Verbs

Where possible, API strives to use appropriate HTTP verbs for each action.

Verb	Description
GET	Used for retrieving sku resources.
POST	Used for creating sku resources.
PUT	Used for updating sku resources.
DELETE	Used for deleting sku resources.

Authentication

Kali server use a strict Oauth2 'client_credentials' authentication. You have to generate a client to recieve a public and secret key to request a valid token to fetch the API. This token expires after 1 hour by default, so you'll have to request another one.

Request Token

GET https://{projectDomain}/oauth/v2/token?client_id={your public key}&client_secret={your secret key}&grant_type=client_credentials

Returned JSON

{
    "access_token": "{your access token}",
    "expires_in": 3600,
    "token_type": "bearer",
    "scope": null
}

Use Token to fetch API

Request Route

POST https://{projectDomain}/api

Headers parameters

Name	Type	Description
Authorization	string	'Bearer {the access token }'

CLI example

curl -H "Authorization: Bearer {access_token}" https://{projectDomain}/api