🚀 Enigma API Reference

Access cryptographic challenges, scores, and puzzle metadata through our powerful and secure REST API.

📦 Developer Onboarding

🎯 Getting Started

🌐 Base URL

https://api.enigma.com

🔐 Authentication

Use Bearer Authentication with your API key obtained from your dashboard.

Authorization: Bearer YOUR_API_KEY

🔍 Available Endpoints

🧩 GET /challenges

Parameters

  • • category (optional)
  • • difficulty (optional)
  • • page (required)

Response

Paginated list of all available challenges with metadata

Example

{
  "data": [
    {
      "id": 1,
      "title": "Vigenère Cipher",
      "type": "crypto",
      "difficulty": "medium"
    }
  ],
  "pagination": {
    "total_pages": 3
  }
}

🏆 GET /leaderboard

Parameters

  • • challenge_id (required)
  • • limit (optional, max: 100)

Response

Sorted ranking of puzzle solvers with completion times

Example

{
  "data": [
    {
      "username": "cryptoqueen",
      "completion_time": "00h 23m 57s"
    }
  ],
  "rank": 1
}

✅ POST /solutions

Body Parameters

  • • challenge_id (required)
  • • solution_hash (required)

Response

Indicates solution status with confirmation or validation

Example

{
  "status": "success",
  "message": "Solution accepted",
  "points_awarded": 150
}

⚠️ Error Handling

401 Unauthorized

Authentication missing or invalid

404 Not Found

Requested resource endpoint is invalid

429 Too Many Requests

Rate limit (150 requests/minute) exceeded

500 Internal Error

API server issue, retry after 10-15 seconds