utilapi

Official Node.js SDK for UtilAPI — a free, no-auth utility API.

npm install utilapi

Quick start

import { UtilAPI } from 'utilapi';

const api = new UtilAPI();
// Optional: custom base URL
// const api = new UtilAPI({ baseUrl: 'https://api.utilapi.com' });

// Encode text to Base64
const { result } = await api.action({
  command: 'encode.base64',
  data: ['hello'],
});
console.log(result); // "aGVsbG8="

// Hash with SHA-256
const hash = await api.action({
  command: 'hash.sha256',
  data: ['hello'],
});
console.log(hash.result.hash);

// Generate a UUID (no data needed)
const uuid = await api.action({ command: 'generate.uuid' });
console.log(uuid.result.uuid);

// Current time — data maps to params in order: [tz]
const now = await api.action({
  command: 'date.now',
  data: ['Asia/Kolkata'],
});
console.log(now.result.iso);

The action API

Every endpoint is called through a single method. The command matches the REST path without the leading slash (e.g. encode.base64 → GET /encode/base64). Values in data are positional — they map to query parameters in the order listed in the API reference.

await api.action({
  command: 'encode.base64', // → GET /encode/base64
  data: ['hello'],          // → ?text=hello
});

Response format

{
  "ok": true,
  "endpoint": "/encode/base64",
  "result": "aGVsbG8=",
  "ms": 1
}

Error handling

import { UtilAPI, UtilAPIError } from 'utilapi';

const api = new UtilAPI();

try {
  const response = await api.action({
    command: 'hash.sha256',
    data: ['hello'],
  });

  if (!response.ok) {
    console.error(response.error);
    return;
  }

  console.log(response.result);
} catch (err) {
  if (err instanceof UtilAPIError) {
    console.error('Request failed:', err.message);
  }
}

Requirements

• Node.js 18+ (uses native fetch)

License

MIT