api.

programmatic access to telis. free, public, and live. no key is required. he is the key.

GET /api/telis

200 ok

returns the current telis.

{
  "telis": true,
  "dancing": false,
  "version": "2.6.1",
  "uptime": "yes",
  "region": "cy-central-1"
}

dancing is always false over http. he only dances when observed.

try it

GET /api/dance

402 payment required

initiates a dance over the api.

{
  "error": "payment required",
  "detail": "dancing over the api is a pro feature. upgrading to pro is not possible. telis says no. use the website. telis must see you."
}

try it

GET /api/coffee

418 i'm a teapot

requests coffee from telis.

{
  "error": "telis is not a coffee machine. telis is a telis."
}

try it

GET /?s=17

200 ok

queues noise 17 of 33 on the home page.

pressing telis is still required.
some things cannot be automated.

try it

authentication

none. telis trusts you.

rate limits

one telis per request. the service is a single instance and cannot be horizontally scaled.

pagination

the collection contains one item. there are no additional pages.

sandbox

there is no sandbox. every request reaches the production telis. please be considerate.

versioning

the api is versioned. there is one version. it is the current one.

sdks

there are no official sdks. the recommended client is a hand.

status codes

200: telis
402: telis, but pro
404: no telis
418: telis is not a coffee machine
429: telis is one person
500: impossible
503: telis is asleep. retry after sunrise.