Universal Base64 & Base32 Encoder

This API provides access to encoding and decoding Base64 & Base32 encoding/decoding.

Decoding Feature

When decoding, if the system detects that the result is a binary file (Image, Audio, PDF, Zip) or a massive text block, it will automatically upload the result to a cloud host and return a direct download link instead of returning raw binary data.

Endpoint

POST /api/v1/encoder

Request Parameters

The following parameters are accepted in the request body:

Field	Type	Required	Description
text	string	Yes	The string to process.
type	string	Optional	base64 (default) or base32.
mode	string	Optional	encode (default) or decode.

Request Examples

Choose your preferred method to interact with the Encoder API:

cURL

curl -X POST https://heavstal.com.ng/api/v1/encoder \
-H "Content-Type: application/json" \
-H "x-api-key: <YOUR_API_KEY>" \
-d '{"text": "Heavstal Tech", "mode": "encode", "type": "base64"}'

JavaScript (Fetch)

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

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

Heavstal SDK

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

const encoded = await tools.encoder("Heavstal Tech", "base64", "encode");
console.log(encoded.data.output);

// Decoding a file
const decodedFile = await tools.encoder("/9j/4AAQSkZJRgABAQAAAQABAAD...", "base64", "decode");
console.log(decodedFile.data.output); // Returns a URL if it's an image/file

Python

import requests

url = "https://heavstal.com.ng/api/v1/encoder"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "<YOUR_API_KEY>"
}
payload = {
    "text": "Heavstal Tech",
    "mode": "encode",
    "type": "base64"
}

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

Response Examples

Success Response (Text)

{
  "status": "success",
  "creator": "HEAVSTAL TECH",
  "data": {
    "type": "base64",
    "mode": "encode",
    "output": "SGVhdnN0YWwgVGVjaA==",
    "is_file": false
  }
}

Success Response (File)

{
  "status": "success",
  "creator": "HEAVSTAL TECH",
  "data": {
    "type": "base64",
    "mode": "decode",
    "output": "https://files.catbox.moe/xyz123.jpg",
    "is_file": true,
    "file_type": "JPG",
    "file_size": "450.20 KB"
  }
}

Error Response

{
  "status": "error",
  "error": "Invalid base64 string provided for decoding."
}