Dalibor Farny Puri Nixie, Manual

Page: 19 / 72

2.4.4. Cloud API
Some of our nixie clocks can be controlled programmatically over REST API. This feature offers
possibilities to display custom numbers or control brightness over the clock as you wish. Individual API
calls are sent to our cloud server that communicates with the clock. The clock must be connected to the
internet to make the API calls work properly.
Authentication
You will need to know or get the following variables for communication with our clocks:
• EMAIL, PASSWORD – use the same credentials as for our web or mobile app
• ACCESS_TOKEN – you will get one after successful login. Every other API call must be
authorized using this token. Session token has an expiration time of 1 year.
• CLOCK_ID – See the table below in section Clock IDs.
• API URL – https://api.daliborfarny.com/
Clock IDs
Each clock model has a certain product ID, Zen clocks 2, 4-tube Puri 6, etc. This is not a serial number
that is unique for each clock.
Clock Name Clock ID
Zen Nixie Clock 2
Puri Nixie Clock (4-tube) 6
Puri Nixie Clock (6-tube) 15
Nixie Machine II 3
Nixie Machine III 9
NX.2 4
Obtaining the ACCESS_TOKEN
Use your EMAIL and PASSWORD to obtain ACCESS_TOKEN . Replace EMAIL and PASSWORD with
the actual credentials you are using on https://user.daliborfarny.com/ or in the mobile app.
API call specification:
• Request type – POST
• Endpoint URL –
/oauth/token
• Request body –
client_id=3rdparty&client_secret=ws7TQHXp5W6444t4&grant_typ
e=password&username=EMAIL&password=PASSWORD
Example API call using curl:
Daliborfarny.com Puri Nixie Clock - 1_en
Page 16 of 69