API Usage
This is the current API, no API key needed. Get all the UUID’s you need!
API Base Url
Section titled “API Base Url”https://uuid.rocks
Global Flags
Section titled “Global Flags”?readable
Section titled “?readable”Switches from standard uuidv4 format to Readable UUIDs, that are Shakespearean grammatically correct sentences.
Eg. Nertie Irwin Farris the Tighter of Chandlerville reminded Erica Aguistin Maryl and 8 dapper jaguars
?short
Section titled “?short”Switches from standard UUIDv4 to a Short ID. These ID’s are converted from UUIDv4 ID’s so they are just as unique & colission free.
Eg. rZMRC1FzqYjVLxNN6iKqqq
Uses the ulidx package to generate ULID’s.
Eg. 01FB0CCPD8R0H9KAJBFQJDFYJB
?nanoid
Section titled “?nanoid”Uses the nanoid package to generate ID’s.
Supports &len=
param to adjust ID length. If this is not a number it will be silently ignored.
If used in combonation with bulk
api, may fail if len
is too long.
Endpoints
Section titled “Endpoints”/short or /s
Section titled “/short or /s”Gets single Short UUID in plaintext
8JcPuGbL63o8JuDAFjiKpx
Gets single ULID in plaintext
01FB0CCPD8R0H9KAJBFQJDFYJB
/nanoid
Section titled “/nanoid”Gets single NANOID in plaintext
ebC664LIj9xy9_8ANdlF4
/stats
Section titled “/stats”Gets some stats about service usage, tracked via countapi.xyz
{"uuids_generated":1376, "stats_viewed_count":77}
Gets single uuid with JSON output
{ "apiVersion": "v1.0.0", "uuid": "cf0def33-cf7d-4648-b42d-3a1253cc4000", "timestamp": "2020-06-11T07:05:15.976Z"}
/json/bulk?count=:count
Section titled “/json/bulk?count=:count”Gets uuids in bulk (up to 20k) with JSON output
https://uuid.rocks/json/bulk?count=3
{ "apiVersion": "v1.0.0", "uuids": [ "648cc8fd-a8ea-486e-bc3b-f64ee74ff4be", "0e0c4a60-5018-408d-88dd-440e40bd92aa", "373e263d-4f8c-485b-9a10-b16838a7717c" ], "timestamp": "2020-06-11T07:05:07.500Z"}
NOTE: Mapping API’s are depricated and will be removed
Section titled “NOTE: Mapping API’s are depricated and will be removed”/json/map/:namespace/:key
Section titled “/json/map/:namespace/:key”Maps a namespace/key combo to the same UUID every time
https://uuid.rocks/json/map/exampleNamespace/exampleKey
{"apiVersion":"v1.1.0","uuid":"e1979ebe-1ab1-44e5-9146-f8dd971e665a","timestamp":"2020-07-13T13:17:50.014Z","created_at":"2020-06-24T20:11:01.284Z","message":"Returned saved UUID!"}
/json/map/:key
Section titled “/json/map/:key”Maps a key to the same UUID every time (in the “default” namespace)
https://uuid.rocks/json/map/exampleKey
{"apiVersion":"v1.1.0","uuid":"e1979ebe-1ab1-44e5-9146-f8dd971e665a","timestamp":"2020-07-13T13:17:50.014Z","created_at":"2020-06-24T20:11:01.284Z","message":"Returned saved UUID!"}
/plain
Section titled “/plain”Gets single UUID in plaintext
9fe6eb19-5c4d-4af1-a72c-e925ad767f57
/plain/bulk?count=:count
Section titled “/plain/bulk?count=:count”Gets uuids in bulk (up to 20k) in plaintext
https://uuid.rocks/plain/bulk?count=3
4dfa8b78-41f3-42e8-ad25-e1a40c7504d4224c9b6a-37be-4abf-8dca-3c29ca210715fe254c86-c16f-4768-a8b8-9a7889141eb9
/plain/map/:namespace/:key
Section titled “/plain/map/:namespace/:key”Maps a namespace/key combo to the same UUID every time
https://uuid.rocks/plain/map/exampleNamespace/exampleKey
e1979ebe-1ab1-44e5-9146-f8dd971e665a
/plain/map/:key
Section titled “/plain/map/:key”Maps a key to the same UUID every time (in the “default” namespace)
https://uuid.rocks/plain/map/exampleKey
e1979ebe-1ab1-44e5-9146-f8dd971e665a