Truth or Dare Engine

This API provides random “Truth” questions or “Dare” challenges to create a fun, interactive experience for chat bots and games.

To make the response visually appealing in modern UI wrappers, it returns the text challenge alongside a curated thematic image URL.

Endpoint

POST /api/v1/truth-dare

Request Parameters

The following parameters are accepted in the request body:

Field	Type	Required	Description
type	string	Yes	Select mode: truth or dare.

Request Examples

cURL

curl -X POST https://heavstal.com.ng/api/v1/truth-dare \
-H "Content-Type: application/json" \
-H "x-api-key: <YOUR_API_KEY>" \
-d '{"type": "dare"}'

JavaScript (Fetch)

const response = await fetch('https://heavstal.com.ng/api/v1/truth-dare', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': '<YOUR_API_KEY>'
  },
  body: JSON.stringify({
    type: 'dare'
  })
});

const res = await response.json();
console.log(res.data.result);

Heavstal SDK

import { tools } from '@heavstal/api';

const game = await tools.truthDare("dare");
console.log(`Dare: ${game.data.result} | Image: ${game.data.image}`);

Python

import requests

url = "https://heavstal.com.ng/api/v1/truth-dare"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "<YOUR_API_KEY>"
}
payload = {
    "type": "dare"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json()["data"])

Response Examples

Success Response

{
  "status": "success",
  "code": 200,
  "creator": "HEAVSTAL TECH",
  "data": {
    "image": "https://files.catbox.moe/dare2.jpg",
    "type": "dare",
    "result": "Do 20 pushups immediately."
  }
}

Error Response

{
  "status": "error",
  "error": "Invalid type provided. Use 'truth' or 'dare'."
}