Skip to main content

​
Find your API URL

To find your API URL, simply log in to Ziik via the browser, copy the URL and append /api. Should look something like this: https://your-identifier.ziik.io/api

​
Get an accesstoken

To get an accesstoken, call the authenticate endpoint with your username and password: 
curl "https://example.ziik.io/api/authenticate"
  -d '{"username":"example@example.com","password":"thisIsMyPassword"}'
The above command returns JSON structured like this: 
[
  {
    "jwt": "aaaaaaaaaa.bbbbbbbbbbb.cccccccccccc",
    "expires": 12345678
  }
]
“expires” is the Unix timestamp of when the accesstoken is no longer valid.

​
Set Authorization header

The API expects the accesstoken to be included in all following API requests: Authorization: Bearer aaaaaaaaaa.bbbbbbbbbbb.cccccccccccc

​
Renew an accesstoken

To renew the accesstoken, simply call the renew endpoint and use the renewed token for future calls. 
curl "https://example.ziik.io/api/renew"
  -H "Authorization: Bearer aaaaaaaaaa.bbbbbbbbbbb.cccccccccccc"