# Hash API
> Compute cryptographic hashes (MD5, SHA-1, SHA-256/384/512, SHA-3, RIPEMD-160) in hex or base64, generate HMAC signatures for webhook and message authentication, and mint v4 UUIDs. All server-side and deterministic. Handy for integrity checks, signing, cache keys, deduplication and id generation.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/hash-api/..."
```

## Pricing
- **Free** (Free) — 8,000 calls/Mo, 3 req/s
- **Basic** ($4/Mo) — 150,000 calls/Mo, 15 req/s
- **Pro** ($14/Mo) — 750,000 calls/Mo, 50 req/s
- **Mega** ($39/Mo) — 4,000,000 calls/Mo, 200 req/s

## Endpoints

### Hash

#### `GET /v1/hash` — Hash digest

**Parameters:**
- `text` (query, required, string) — Text to hash Example: `hello`
- `algo` (query, optional, string) — md5 sha1 sha256 sha512 sha3-256 ripemd160 Example: `sha256`
- `encoding` (query, optional, string) — hex or base64

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hash-api/v1/hash?text=hello&algo=sha256"
```

**Response:**
```json
{
    "data": {
        "algo": "sha256",
        "hash": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
        "length": 5,
        "encoding": "hex"
    },
    "meta": {
        "timestamp": "2026-05-30T07:07:13.370Z",
        "request_id": "13a00bda-6903-4aac-8ed7-189059b9a626"
    },
    "status": "ok",
    "message": "Hash computed",
    "success": true
}
```

#### `GET /v1/hmac` — HMAC signature

**Parameters:**
- `text` (query, required, string) — Message Example: `payload`
- `key` (query, required, string) — Secret key Example: `secret`
- `algo` (query, optional, string) — Digest algo Example: `sha256`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hash-api/v1/hmac?text=payload&key=secret&algo=sha256"
```

**Response:**
```json
{
    "data": {
        "algo": "sha256",
        "hmac": "b82fcb791acec57859b989b430a826488ce2e479fdf92326bd0a2e8375a42ba4",
        "encoding": "hex"
    },
    "meta": {
        "timestamp": "2026-05-30T07:07:13.428Z",
        "request_id": "3a3fff22-c224-4855-8e0c-faf1cb31ef96"
    },
    "status": "ok",
    "message": "HMAC computed",
    "success": true
}
```

#### `GET /v1/uuid` — Generate UUIDs

**Parameters:**
- `count` (query, optional, string) — How many, 1-100 Example: `5`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hash-api/v1/uuid?count=5"
```

**Response:**
```json
{
    "data": {
        "count": 5,
        "uuids": [
            "060513bd-4530-4905-94f5-e189f2c37cf1",
            "71815c94-eb8f-46bc-a4f8-fbcd89a7a720",
            "3f58e8ab-6a45-4b74-b2b2-9fcbcddff4f6",
            "e449a2a2-87d1-4148-a5b2-7552804a8039",
            "cab388ff-76b1-4ea4-bcba-13b55ac1a12d"
        ]
    },
    "meta": {
        "timestamp": "2026-05-30T07:07:13.498Z",
        "request_id": "2cd1a376-ac71-4a77-ae33-44a8c323a476"
    },
    "status": "ok",
    "message": "UUIDs generated",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/hash-api
OpenAPI spec: https://www.oanor.com/api/hash-api/openapi.json