Sign inSign up

altansezerayan/mock-jutsu

By altansezerayan

•Updated 2 months ago

Algorithmic mock data engine. 390 types, stop working with random strings, use Mock Jutsu REST API.

Image
API management
Developer tools
Web servers
0

2.1K

altansezerayan/mock-jutsu repository overview

⁠Mock Jutsu

Algorithmic mock data engine. 390+ types, 6 locales, zero dependencies. Cryptographically valid TCKN, IBAN, Luhn, BIC, MRZ, NFC, and more.

⁠Quick Start

⁠📬 Postman Collection

390 ready-to-run requests organized by category. Import and hit Send.

⁠Collection is bundled in this repo — import directly in Postman:

https://github.com/altansayan/mock-jutsu-api/tree/main/.postman/collections/mock-jutsu.postman_collection.json

For full details on all functions, please refer to the documentation:

docker run -p 8000:8000 altansezerayan/mock-jutsu:latest

API: http://localhost:8000
Swagger UI: http://localhost:8000/docs

Endpoints

┌────────┬───────────────────────┬────────────────────────────────┐
│ Method │         Path          │          Description           │
├────────┼───────────────────────┼────────────────────────────────┤
│ GET    │ /generate/{type}      │ Single value                   │
├────────┼───────────────────────┼────────────────────────────────┤
│ GET    │ /bulk/{type}?count=10 │ Multiple values                │
├────────┼───────────────────────┼────────────────────────────────┤
│ GET    │ /profile              │ Full person profile            │
├────────┼───────────────────────┼────────────────────────────────┤
│ GET    │ /company              │ Company profile                │
├────────┼───────────────────────┼────────────────────────────────┤
│ POST   │ /template             │ Structured records from schema │
├────────┼───────────────────────┼────────────────────────────────┤
│ POST   │ /export               │ Export as JSON / CSV / SQL     │
├────────┼───────────────────────┼────────────────────────────────┤
│ GET    │ /list                 │ All supported types            │
├────────┼───────────────────────┼────────────────────────────────┤
│ GET    │ /health               │ Health check                   │
└────────┴───────────────────────┴────────────────────────────────┘

Examples

# Single TCKN
curl http://localhost:8000/generate/tckn

# 50 IBANs (TR locale)
curl "http://localhost:8000/bulk/iban?count=50&locale=TR"

# Masked credit card (PCI DSS)
curl "http://localhost:8000/generate/pan?mask=true"

# Export CSV
curl -X POST http://localhost:8000/export \
  -H "Content-Type: application/json" \
  -d '{"schema_map":{"id":"uuid","name":"fullname","iban":"iban"},"count":100,"format":"csv"}'

Environment Variables

┌─────────────────────────┬─────────┬──────────────────────────────────┐
│        Variable         │ Default │           Description            │
├─────────────────────────┼─────────┼──────────────────────────────────┤
│ GRANIAN_WORKERS         │ 4       │ Worker process count             │
├─────────────────────────┼─────────┼──────────────────────────────────┤
│ GRANIAN_PORT            │ 8000    │ Port to listen on                │
├─────────────────────────┼─────────┼──────────────────────────────────┤
│ GRANIAN_URL_PATH_PREFIX │ —       │ Sub-path if behind reverse proxy │
└─────────────────────────┴─────────┴──────────────────────────────────┘

Behind a Reverse Proxy (nginx / Caddy)

services:
  mock-jutsu:
    image: altansezerayan/mock-jutsu:latest
    expose:
      - "8000"
    environment:
      - GRANIAN_URL_PATH_PREFIX=/api
    networks:
      - proxy_network

Links

- GitHub: https://github.com/altansayan/mock-jutsu-api
- HOW-TO Guides: https://altansayan.github.io/mock-jutsu-api
- License: MIT - https://github.com/altansayan/mock-jutsu-api/blob/main/LICENSE

---

Tag summary

Content type

Image

Digest

sha256:ea42f5d43…

Size

62.1 MB

Last updated

2 months ago

docker pull altansezerayan/mock-jutsu