Naar de inhoud
GET /v1/random

Random puzzle by theme/rating

Probeer het live

10 gratis calls per dag — geen registratie, geen API-key. Loopt via de oanor-gateway.

Aangepaste headers (optioneel)
api.oanor.com/chesspuzzles-api

Het werkt. Haal een API-key op en gebruik hem in je project.

Verkrijg een API-sleutel

Codefragmenten

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_..."}
)

Voorbeeldrespons

Een echte respons van dit endpoint, vastgelegd bij de laatste health check.

{
    "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
}