Developer API Reference

Create Project API

Group records using the Project API. You could later fetch these records using the Project Fetch Records API.

Root

https://api.ttskit.com/v1

Route

/project

Request Type

POST

Request Headers

Below are the list of Accepted Request Headers if you are trying to Create Project.

Request Header	Value	Required
X-Master-Key	<API_KEY>	Yes

X-Master-Key Required

You will need this Key to access mostly any API end-point on TTSKit. You could find the key on the API Key page.

Query String Parameters

Query String Parameter	Value	Required
name	<Project Name>	Yes
desc	<Project Description>	Yes

name Required

Name is a required parameter which sets the Project Name. You cannot set a name more than 200 characters.

desc Required

Desc is a required parameter to describe the project. You cannot set a desc more than 2000 characters.

Code Samples

cURL
Java
JavaScript (ES6)
Python 3
Ruby

curl -v\
    -H 'X-Master-key: <YOUR_API_KEY>' \
    -d '{"name": "Project Name", "desc": "Project Description"}' \
    --request POST \
    https://api.ttskit.com/v1/project

    HttpPost post = new HttpPost("https://api.ttskit.com/v1/project");

    List<NameValuePair> urlParameters = new ArrayList<>();
    urlParameters.add(new BasicNameValuePair("name", "Project Name"));
    urlParameters.add(new BasicNameValuePair("desc", "Project Description"));

    post.addHeader("X-Master-Key", "<YOUR_API_KEY>");
    post.setEntity(new UrlEncodedFormEntity(urlParameters));

    try (CloseableHttpClient httpClient = HttpClients.createDefault();
            CloseableHttpResponse response = httpClient.execute(post)) {

        System.out.println(EntityUtils.toString(response.getEntity()));
    }

let req = new XMLHttpRequest();

req.onreadystatechange = () => {
    if (req.readyState == XMLHttpRequest.DONE) {
        console.log(req.responseText);
    }
};

req.open("POST", "https://api.ttskit.com/v1/project", true);
req.setRequestHeader("X-Master-Key", "<YOUR_API_KEY>");
req.send(JSON.stringify({"name": "Project Name", "desc": "Project Description"}));

import requests
url = 'https://api.ttskit.com/v1/project'
headers = {
    'X-Master-Key': '<YOUR_API_KEY>'
}
data = {
    'name': 'Project Name',
    'desc': 'Project Description'
}

req = requests.post(url, json=data, headers=headers)
print(req.text)

require 'net/http'
require 'json'

uri = URI("https://api.ttskit.com/v1/project")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
req = Net::HTTP::Post.new(uri)
req['X-Master-Key'] = '<YOUR_API_KEY>'
req.body = {name: 'Project Name', desc: 'Project Description'}.to_json


http.request(req)
end

puts res.body

Request Response

Success Status Code: 200

{
    "code": 200,
    "message": "Success.",
    "status": "success",
    "project": {
        "id": <ID>,
        "name": "Project Name",
        "desc": "Project Description"
        ...
    }
}

Error Status Code: 400, 401, 402, 403, 500

{
    "code": 400,
    "message": "<Error Message>",
    "subMessage": "<Error Message Detail>",
    "status": "error"
}

For more information on the error codes & errors you might possibly encounter, refer to the below section.

Error Reference

400 Bad Request
401 UnAuthorized
402 Payment Required
403 Forbidden

Invalid Route

To solve this issue, simply provide the correct Route.

Ensure your data complies with data constraints

You can refer to "subMessage" for more details.

You need to pass X-Master-Key in the header

You'll encounter this error if you are not passing the X-Master-Key header which is required to authenticate your request. In-order to fix this, pass the X-Master-Key header with a value of the API Key which you can find on the API Keys page.

Currently, The API is only supported for premium users. Upgrade to Premium plan https://ttskit.com/pricing to use these features

You need to upgrade your account to the Premium Plan to use these features.

You are making requests too fast.

Approximately 1 request every 2 seconds.

DEVELOPERS API REFERENCE (v1.0)