Skip to content

Random Forge API

The Random Forge API generates random values and common hashes from a single endpoint. It supports random strings, passwords, hashes, bcrypt values, UUIDs, and lists of generated values.

Response Format

The endpoint returns plain text for single-value outputs and a list format for type=list requests.

Example Outputs:

  • Random string.
  • Random password.
  • Hash value.
  • Bcrypt hash.
  • UUID v4.
  • A list of generated strings.

Authentication Methods

This endpoint is publicly accessible and does not require authentication.

Characteristics:

  • No authentication required
  • Supports multiple output types
  • Suitable for testing, tokens, and placeholder data
  • Can return either a single value or a list

Usage:

curl "https://api.tylermwise.uk/v1/randomforge?type=list&length=16&count=25"

Endpoint

GET /v1/randomforge

Example Requests

curl "https://api.tylermwise.uk/v1/randomforge?type=string&length=32"

curl "https://api.tylermwise.uk/v1/randomforge?type=password&length=20&special=false"

curl "https://api.tylermwise.uk/v1/randomforge?type=hash&algorithm=sha256&input=helloworld"

curl "https://api.tylermwise.uk/v1/randomforge?type=bcrypt&password=MySecurePass123"

curl "https://api.tylermwise.uk/v1/randomforge?type=uuid"

curl "https://api.tylermwise.uk/v1/randomforge?type=list&length=16&count=25"

Query Parameters

Parameter Type Default Description
type string string Output type. Options include string, password, hash, bcrypt, uuid, and list.
length int 16 Length of the generated string or password.
chars string all alphanum Custom character set.
algorithm string sha256 Hash algorithm. Options include md5, sha1, sha256, sha384, and sha512.
input string random Input value for hash generation.
password string random Password used for bcrypt hashing.
upper bool true Include uppercase characters in passwords.
lower bool true Include lowercase characters in passwords.
digits bool true Include digits in passwords.
special bool true Include special characters in passwords.
count int 10 Number of strings to return when type=list.

Response Examples

Random String

A1b2C3d4E5f6G7h8

Random Password

G7#rQ2!mLp9X

Hash Output

936a185caaa266bb9cbe981e9c9f1e987a0d1d8c

UUID Output

550e8400-e29b-41d4-a716-446655440000

List Output

[
    "aB3kLm9Pq2RsT7Uv",
    "X1yZ8n4Qw6ErT9uI"
]

Notes

  • The type parameter controls the output mode.
  • The type=list mode returns multiple generated values.
  • The chars parameter lets you define your own allowed characters.
  • The algorithm parameter applies when generating hashes.
  • The password parameter applies when generating bcrypt values.
  • The example type=list&length=16&count=25 returns 25 random strings, each 16 characters long.

HTTP Status Codes

Standard responses may include:

  • 200 - Success.
  • 400 - Bad Request.
  • 429 - Too Many Requests.
  • 500 - Internal Server Error.

Versioning

This page documents version 1 of the RandomForge API, available under the /v1/ path.