This endpoint generates the following:

  • Sequential and unique numeric id's
  • Random and unique Char Id's

These are used for all sorts of things analytics/sessions/security.

Collection /id

Generate sequential and unique numeric integer and char id's

GET /id

Get a unique and possibly sequential integer ID

item value
Access public
Full url https://api.buto.tv/v2/id
verb GET
params none

Example usage

#get a 32 bit unique sequential integer
curl --include https://api.buto.tv/v2/id

returns

HTTP/1.1 200 OK
...
Content-Type: application/json

{"id":"11167538"}

Collection /id/char

Generate random and unique char Id's of a specified length
You can see and try a demo endpoint here as well as seeing all the error codes:

Apiary Demo

GET /id/char/{length}


  • length - DEFAULT 7, specify a length between 4 and 10 chars
item value
Access SYSTEM KEYS ONLY
Full url https://api.buto.tv/v2/id/char/{length}
verb GET
params int:length

Example usage

#get a 8 char id
curl -u API_KEY:x --include https://api.buto.tv/v2/Id/char/8

returns

HTTP/1.1 200 OK
...
Content-Type: application/json

{"id":"289NfKDx","length":"8"}