/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.
Het werkt. Haal een API-key op en gebruik hem in je project.
Verkrijg een API-sleutelCodefragmenten
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
}