Ghosted Development Documentation

Ghosted Development API

Welcome to the official Ghosted Development utility API documentation. Our endpoints are simple, fast, and accessible for general developer automation needs.

Base URL

https://api.ghosted-development.space
Note: All utility endpoints return structured JSON responses. Please include appropriate headers and parameters.

Utility Endpoints

GET/time-diff

Calculates the time difference between a given Unix timestamp and the current time.

Parameters

timestamp={Unix Timestamp in seconds}

Example Request

GET /time-diff?timestamp=1700000000

Example Response

{
"timestamp": 1700000000,
"days": 2,
"hours": 0,
"minutes": 18,
"seconds": 0,
"success": true
}
GET/8ball

Returns a Magic 8-Ball style answer based on a given question.

Parameters

question={Text}

Example Request

GET /8ball?question=Will%20I%20win?

Example Response

{
"question": "Will I win?",
"answer": "Outlook good.",
"type": "positive",
"success": true
}
GET/morse-code

Automatically encodes or decodes a given text string into or from Morse code.

Parameters

text={Text}

Headers

Operation=Encode | Decode

Example Request (Encode)

GET /morse-code?text=Hello
Operation: Encode

Example Response (Encode)

{
"input": "Hello",
"output": ".... . .-.. .-.. ---",
"operation": "ENCODE",
"success": true
}
GET/binary

Automatically encodes or decodes a given text string into or from Binary.

Parameters

text={Text}

Headers

Operation=Encode | Decode

Example Request (Encode)

GET /binary?text=Hello
Operation: Encode

Example Response (Encode)

{
"input": "Hello",
"output": "01101000 01100101 01101100 01101100 01101111",
"operation": "ENCODE",
"success": true
}
GET/temperature-convert

Converts temperatures between Celsius (C) and Fahrenheit (F).

Parameters

value={Numeric temperature value}

Headers

Operation= CELSIUS TO FAHRENHEIT | FAHRENHEIT TO CELSIUS

Example Request (Fahrenheit to Celsius)

GET /temperature-convert?value=32
Operation: FAHRENHEIT TO CELSIUS

Example Response

{
"value": 0,
"unit": "C",
"unit_type": "Celsius",
"success": true
}
GET/number-formatter

Formats large numbers using a custom separator for thousands.

Parameters

number={Large integer}
separator={Character to use as separator, e.g., ., or ,}

Example Request

GET /number-formatter?number=4532134521342&separator=.

Example Response

{
"formatted": "4.532.134.521.342",
"original": 4532134521342,
"separator": ".",
"success": true
}
POST/purge-messages

Deletes a requested number of messages (MAX 1000).

Headers

bot_token: {BOT_TOKEN}
Purge-Channel-ID: {CHANNEL_ID} - The channel you want to delete the messages from
Log-Channel-ID: {CHANNEL_ID} - The channel to send the log to
Limit: {NUMBER} - How many messages you want to delete

Example Response

{
"purgeChannelId": 123456789012345678,
"logChannelId": 123456789098765432,
"requestedLimit": 1000,
"messagesPurged": 472,
"logMessageSent": true
}

Rate Limits

As this is a public API, requests are limited based on your IP address to ensure service stability and fair usage for all developers.

Current Limits

  • Limit: 100 requests per minute (RPM) per IP address.
  • Burst: A burst limit of 10 requests is allowed within the first second.
429 Too Many Requests: Exceeding rate limits will result in an HTTP 429 response detailing the delay period.

Rate Limit Response Example

{
"success": false,
"error": "Rate limit exceeded. Try again in 5 seconds."
}

Error Response Format

All non-200 responses return a consistent JSON structure to help you debug quickly.

Standard Error Structure

{
"success": false,
"error": "Descriptive message detailing the issue (e.g., Missing parameter, Invalid value)."
}

Common Status Codes

  • 400 Bad Request: Missing or invalid required query parameters.
  • 429 Too Many Requests: Rate limit exceeded.
  • 500 Internal Server Error: A problem occurred on the server.