Try one
Each of these is a working link. Change the numbers and words in the address to get something else.
/1/uidOne ID, upper case, no hyphens
/5/nanoFive nano IDs
/json/10/uuidTen v4 UUIDs as JSON
/caps/no-hyphens/20/v5Twenty v5 UUIDs, upper case, no hyphens
/string/3/v1Three time-based UUIDs on one line
/10/nano/n21Ten nano IDs, 21 characters each
What you can put in the URL
Segments can come in any order. Leave one out and the generator uses its default.
| Count | Any whole number from 1 to 1,000. Default: 1. |
|---|---|
| Type | uuid or v4 (random), v1 (time-based), v3 and v5 (name-based), nano or nanoid, and uid (a v4 UUID in upper case without hyphens). Default: uid. |
| Format | json (a list, one per line), string (separated by spaces), array (in brackets, separated by commas). Default: json. |
| Options | caps, cap, upper or up; lower or low; no-hyphens or undash. |
| Nano length | n and a number, for example n21, from 2 to 64. Default: 10. |
From the terminal
Anything that isn’t a browser gets plain text back, so the same URLs work in scripts:
curl https://uid.fredlackey.com/string/3/uuid
Through the API
Send a POST to /api with a JSON body. You get back the settings that were used and the values.
curl -X POST https://uid.fredlackey.com/api \
-H 'Content-Type: application/json' \
-d '{"uidType":"uuid","length":5,"format":"json","options":["caps"]}'
The body takes uidType, length and format, and optionally nsize (the nano ID length) and options (a list), with the same values as the URL.