API Documentation

Integrate DevTools generators and utilities directly into your applications. All endpoints require an API key from your dashboard.

Get API Key

Generate a key from your dashboard after subscribing to an API plan

Authenticate

Pass your key via Authorization: Bearer header on every request

Start Building

All endpoints return JSON with rate limit headers included

Base URL

url

https://tools.shafyha.com/api/tools

Authentication

bash

# Option 1: Authorization header (recommended)
curl "https://tools.shafyha.com/api/tools/uuid" -H "Authorization: Bearer YOUR_API_KEY"

# Option 2: Query parameter
curl "https://tools.shafyha.com/api/tools/uuid?api_key=YOUR_API_KEY"

Rate Limits

Plan	Requests/day	Price	Best for
API Basic	2,000/day	$2/mo	Hobby projects, prototypes
API Pro	15,000/day	$5/mo	Production apps
Starter	2,000/day	$3/mo	Includes other features
Pro	15,000/day	$8/mo	All features included
Business	100,000/day	$20/mo	High volume usage

Rate limit resets at 00:00 UTC daily. Limit headers are included in every response: X-RateLimit-Limit and X-RateLimit-Remaining.

Error Responses

401UnauthorizedMissing or invalid API key

403ForbiddenNo active subscription for this API product

400Bad RequestMissing required parameter or invalid value

409ConflictCustom slug already taken (URL shortener)

429Too Many RequestsDaily rate limit exceeded. Resets at UTC midnight

500Server ErrorSomething went wrong on our end

json

{ "success": false, "error": "Error message here", "details": null }

Endpoints

Generate cryptographically random passwords.

Parameters

Name	Type	Default	Description
length	number	16	Password length (4-128)
count	number	1	Number of passwords (1-50)
uppercase	boolean	true	Include uppercase letters
lowercase	boolean	true	Include lowercase letters
numbers	boolean	true	Include numbers
symbols	boolean	false	Include symbols (!@#$...)

Example Request

bash

curl "https://tools.shafyha.com/api/tools/password?length=20&symbols=true&count=3" \
    -H "Authorization: Bearer YOUR_API_KEY"

Example Response

json

{
      "success": true,
      "data": {
        "passwords": ["K#9mP!vQ2xR@nL5wY", "J$8kN@uW3yT!mF6zA", "M%7jH#sV4zP@lE9xB"]
      },
      "meta": { "rate_limit_day": 2000, "requests_today": 1, "remaining_today": 1999 }
    }

Ready to integrate?

Get your API key from the dashboard. API Basic starts at just $2/month for 2,000 requests/day.

Get API Key View Plans