Other Endpoints

Returns a random 5-letter word from a curated wordlist. Perfect for starting a new Wordle game. The wordlist contains common English words suitable for word-guessing games.

Responses

{ "word": "apple" }

{ "error": "Word list is empty" }

{
  "error": "Failed to load word list",
  "details": "ENOENT: no such file or directory"
}

BDFD Example

$httpGet[https://api.bdtools.xyz/random-word]

Validates whether a 5-letter word is a valid English word. First checks the curated wordlist, then falls back to an external dictionary. Returns the validation result and the source of validation (wordlist or dictionary).

Query Parameters

Responses

{
  "valid": true,
  "word": "apple",
  "source": "wordlist"
}

{
  "valid": true,
  "word": "zebra",
  "source": "dictionary"
}

{
  "valid": false,
  "word": "xyzqw"
}

{ "error": "Missing ?word= parameter" }

{ "error": "Word must be exactly 5 letters" }

{
  "error": "Failed to reach dictionary",
  "details": "Network timeout"
}

{
  "error": "Dictionary error",
  "status": 503
}

BDFD Example

$httpGet[https://api.bdtools.xyz/validate-word?word=apple]

Returns a random Pokemon name from all generations (1-9, over 1000 Pokemon). Can optionally return the Pokemon sprite image by adding ?image=true. Images are sourced from PokeAPI's official artwork collection. You can also request a specific Pokemon by name using the ?name= parameter, or filter by generation using ?gen=.

Query Parameters

Generations

// Gen 1: Kanto (1-151)
// Gen 2: Johto (152-251)
// Gen 3: Hoenn (252-386)
// Gen 4: Sinnoh (387-493)
// Gen 5: Unova (494-649)
// Gen 6: Kalos (650-721)
// Gen 7: Alola (722-809)
// Gen 8: Galar (810-905)
// Gen 9: Paldea (906-1025)

Responses

{ "pokemon": "pikachu" }

{ "error": "Invalid generation. Must be between 1 and 9." }

{ "error": "Pokemon not found" }

{
  "error": "Pokemon image not found",
  "pokemon": "pikachu"
}

{ "error": "Pokemon list is empty" }

{
  "error": "Failed to fetch Pokemon image",
  "details": "Network timeout"
}

Example Usage

// Random Pokemon from all generations
$httpGet[https://api.bdtools.xyz/random-pokemon]

// Random Pokemon from Gen 1 (Kanto)
$httpGet[https://api.bdtools.xyz/random-pokemon?gen=1]

// Random Pokemon from Gen 2 (Johto)
$httpGet[https://api.bdtools.xyz/random-pokemon?gen=2]

// Random Gen 1 Pokemon image
$image[https://api.bdtools.xyz/random-pokemon?gen=1&image=true]

// Specific Pokemon name
$httpGet[https://api.bdtools.xyz/random-pokemon?name=charizard]

// Specific Pokemon image
$image[https://api.bdtools.xyz/random-pokemon?name=pikachu&image=true]

Converts a large number string into a short, human-readable format. Use Case: Displaying large numbers concisely (e.g., 100k, 1M, 1B).

Query Parameters

Responses

{
  "original": "100000",
  "short": "100k"
}

{ "error": "Missing number parameter 'n'." }

{ "error": "Invalid number provided." }

Example Usage

// Basic shortening
$httpGet[https://api.bdtools.xyz/number-shortener?n=100000]

// Comma-separated input
$httpGet[https://api.bdtools.xyz/number-shortener?n=1,250,000]

// Very large number
$httpGet[https://api.bdtools.xyz/number-shortener?n=9876543210]

Validates a provided JSON payload. Returns valid: true or valid: false with specific error details if invalid.

Request Body

{
    "test": 123
}

Responses

{
  "valid": true,
  "message": "JSON is valid."
}

{
  "valid": false,
  "error": "Invalid JSON.",
  "details": "Expected ',' or '}' at position 10"
}

{ "error": "Method not allowed. Use POST." }

Example Usage

// Validate a simple JSON object
$httpPost[https://api.bdtools.xyz/json-validator;
{
"name":"BDTools",
"count":3
}]

// Validate a nested JSON payload
$httpPost[https://api.bdtools.xyz/json-validator;
{
"user":{
 "id":123,
 "tags": ["api","docs"]
  },
"active":true
}]