docs / api-reference

API Reference

Guide

Public REST API for ekisde.dev. Password generator endpoint with rate limiting. No authentication required.

← back to docs

content

# API Reference

Base URL: https://ekisde.dev/api

All responses are JSON. The API is public — no authentication required.
Rate limited to 20 requests per minute per IP.

---

## Password Generator

Generate a cryptographically secure random password.

**Endpoint**
GET /api/generate/password

**Query parameters**

| Parameter | Type    | Default | Description                  |
|-----------|---------|---------|------------------------------|
| length    | integer | 16      | Password length (8–128)      |
| symbols   | boolean | true    | Include symbols !@#$%…       |
| numbers   | boolean | true    | Include digits 0–9           |
| uppercase | boolean | true    | Include uppercase A–Z        |

**Example request**
curl "https://ekisde.dev/api/generate/password?length=20&symbols=false"

**Example response**
{
  "password": "kX9mP2qR7vN4wZ3hL8",
  "length": 18,
  "options": {
    "symbols": false,
    "numbers": true,
    "uppercase": true
  }
}

**Rate limit response (429)**
{
  "error": "Rate limit exceeded.",
  "retry_after": 34
}

---

## Try it

Visit https://ekisde.dev/api/ for a live interactive tester.