Μετάβαση στο περιεχόμενο
GET /v1/random

Random puzzle by theme/rating

Δοκιμάστε το ζωντανά

10 δωρεάν κλήσεις την ημέρα — χωρίς εγγραφή, χωρίς κλειδί API. Μέσω του gateway του oanor.

Προσαρμοσμένες κεφαλίδες (προαιρετικά)
api.oanor.com/chesspuzzles-api

Δουλεύει. Πάρε ένα κλειδί API και χρησιμοποίησέ το στο έργο σου.

Λάβετε ένα κλειδί API

Αποσπάσματα κώδικα

curl "https://api.oanor.com/chesspuzzles-api/v1/random" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/chesspuzzles-api/v1/random", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/chesspuzzles-api/v1/random");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/chesspuzzles-api/v1/random",
    headers={"x-oanor-key": "oanor_test_..."}
)

Παράδειγμα απόκρισης

Πραγματική απόκριση αυτού του endpoint, από τον τελευταίο έλεγχο υγείας.

{
    "data": {
        "id": "93O0S",
        "fen": "4rrk1/pp4pp/2np2b1/5N2/3P1R2/2P5/PP3QKR/3q4 b - - 0 23",
        "url": "https://lichess.org/training/93O0S",
        "moves": [
            "e8e2",
            "f5e7",
            "c6e7",
            "f4f8"
        ],
        "rating": 1415,
        "themes": [
            "discoveredAttack",
            "kingsideAttack",
            "mate",
            "mateIn2",
            "middlegame",
            "short"
        ],
        "game_url": "https://lichess.org/prwN5T0y/black#46",
        "nb_plays": 1860,
        "popularity": 96,
        "opening_tags": [],
        "solver_color": "white"
    },
    "meta": {
        "timestamp": "2026-05-30T22:48:33.072Z",
        "request_id": "dd5c1e82-6b6d-40f7-be23-59066d7bbe6c"
    },
    "status": "ok",
    "message": "Random puzzle retrieved",
    "success": true
}