apyhub
DEVELOPER TOOLS

Generate Random String API

What it does

Random String Generator creates a random string of a chosen length and character set. Send a length from 1 to 256 and a charset, and get back a generated value along with the length and charset used.

Use it when you need unique tokens for test data, disposable identifiers, fixture values, or placeholder secrets that must follow a specific character pattern. The supported character sets are alpha, alphanumeric, numeric, and hex, so you can generate everything from simple alphabetic labels to hexadecimal strings for internal tooling.

The response is small and predictable, which makes it easy to plug into scripts, backend jobs, or developer utilities. If you are filling forms, building sample records, or generating temporary values for QA, Random String Generator gives you exactly the format you requested without extra metadata.

GET
Generate a random string of specified length and character set
http://localhost:8080/dosvak/random-string
QUICKSTARTGUIDE

Quickstart

Generate a random string with the default settings.

curl -X GET "http://localhost:8080/dosvak/random-string?length=16&charset=alphanumeric" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with value as a string, length as an integer, and charset as a string.

{
  "value": "x7Kp9Lm2Qv4R",
  "length": 16,
  "charset": "alphanumeric"
}
TRY ITLIVE · 10 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Generates a random string using the requested length and character set, and returns the generated string along with the length and charset used.

Query Parameter(s)

AttributeTypeMandatoryDescription
lengthIntegerNoNumber of characters to generate. Default: 16. Minimum: 1. Maximum: 256.
charsetENUMNoCharacter set to use. Allowed values: alpha, alphanumeric, numeric, hex. Default: alphanumeric.

Response

Returns a JSON object with value, length, and charset fields. value is the generated random string, length is the string length, and charset is the character set used.

ParameterTypeMandatoryDescription
valueStringYesThe generated random string.
lengthIntegerYesThe length of the generated string.
charsetStringYesThe character set used to generate the string.

Query parameters

Name
Type
Description
lengthOPTIONAL
integer
DEFAULT 16
charsetOPTIONAL
string
alpha · alphanumeric · numeric · hex
DEFAULT alphanumeric
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.