Spec

Extraits de code

curl "https://api.oanor.com/tournament-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/tournament-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/tournament-api/v1/meta");
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/tournament-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "name": "Tournament Scheduler API",
        "notes": "Round-robin with an odd count adds a bye each round. Brackets round up to a power of two and give byes to the highest seeds; later rounds are TBD until winners are known. This generates schedules — for live sports results and fixtures use a sports data API. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/roundrobin",
                "params": {
                    "double": "true for a double round-robin (home and away)",
                    "participants": "a list of names (comma or JSON) or a number"
                },
                "returns": "the round-by-round schedule with byes"
            },
            {
                "path": "/v1/bracket",
                "params": {
                    "seeded": "true (default) for standard seeding so byes go to top seeds",
                    "participants": "a list of names or a number"
                },
                "returns": "the single-elimination bracket, round by round"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Generate tournament schedules. The roundrobin endpoint builds a full round-robin fixture list where every participant plays every other exactly once (or twice, home and away, with double=true) — using the circle method, balancing home/away and inserting a bye automatically for an odd number of entrants. The bracket endpoint builds a single-elimination bracket: it rounds up to the next power of two, seeds the entrants in standard bracket order (1 plays the lowest seed, and top seeds meet late) so byes go to the highest seeds, and lays out every round through the Final. Give it a list of names or just a number of participants. Pure local, no key."
    },
    "meta": {
        "timestamp": "2026-06-03T09:24:59.873Z",
        "request_id": "f788398e-b396-445a-912a-1478a7c287d3"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}