Random Generator APIs

UUID and GUID

{
  "uuid": "429151ee-82a1-4438-b2f1-b6b9c9e4a41f"
}

{
  "guid": "750dd9a6-a507-4a89-b4ec-8cd71fc115b7"
}

Both endpoints return a version 4 style identifier as a string. The response key matches the endpoint name.

Random number

The number is inclusive of both bounds. With no parameters the range is 1 through 6.

curl https://aisenseapi.com/services/v1/random_number/1/100

{
  "random_number": 73,
  "range": { "from": 1, "to": 100 }
}

Random password

The default length is 12 characters. Add a length to the URL when another size is needed. The generated value includes punctuation.

curl https://aisenseapi.com/services/v1/password/16

{
  "password": "jFehS]AKGx9wl[jp",
  "password_length": 16
}

The value is uniform character soup, which is fine when a machine stores it. When a person has to read it aloud or retype it, use the passphrase endpoint instead.

Passphrase

The argument counts groups, not characters. Four hyphen separated groups is the default and 2 through 12 are allowed. Groups are built from consonant-vowel syllables, so the result can be read aloud, dictated over a phone and retyped from memory. One digit and one symbol are always included.

curl https://aisenseapi.com/services/v1/passphrase

{
  "passphrase": "hudil-rosi4-Zerzo-Coze#",
  "groups": 4,
  "length": 23,
  "entropy_bits": 91.4
}

Out of range group counts return HTTP 400. The reported entropy is accumulated from the random draws that produced that one passphrase rather than estimated from the finished string, so two calls with the same group count differ by a few bits. Two groups is around 57 bits, four groups around 91 and six groups around 133. The default is in the region of a 14 character fully random password.

Random color

The endpoint returns a six-digit hexadecimal CSS color.

curl https://aisenseapi.com/services/v1/random_color

{ "random_color": "#9b6bbf" }

This is useful for placeholders, test data and visual prototypes where repeatability is not required.

Common uses

Limits

The service-wide limit is 5000 requests per IP per 24 hours. These endpoints are convenient for public tests and workflows. Generate sensitive secrets inside your own trusted environment.

Related APIs