Zum Inhalt springen
GET /v1/character

A character by name, or the full roster

Live testen

10 freie Calls pro Tag — keine Anmeldung, kein API-Key. Geht durchs oanor-Gateway.

Eigene Header (optional)
api.oanor.com/genshin-api

Funktioniert. Hol dir einen API-Key und nutze sie in deinem Projekt.

API-Key holen

Code-Snippets

curl "https://api.oanor.com/genshin-api/v1/character" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/genshin-api/v1/character", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/genshin-api/v1/character");
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/genshin-api/v1/character",
    headers={"x-oanor-key": "oanor_test_..."}
)

Beispiel-Response

Echte Antwort dieses Endpoints, erfasst beim letzten Health-Check.

{
    "data": {
        "character": {
            "name": "Albedo",
            "title": "Kreideprinz",
            "gender": "Male",
            "nation": "Mondstadt",
            "rarity": 5,
            "vision": "Geo",
            "weapon": "Sword",
            "outfits": [],
            "release": "2020-12-23",
            "birthday": "0000-09-13",
            "affiliation": "Knights of Favonius",
            "description": "A genius known as the Kreideprinz, he is the Chief Alchemist and Captain of the Investigation Team of the Knights of Favonius.",
            "constellation": "Princeps Cretaceus",
            "skill_talents": [
                "Favonius Bladework - Weiss",
                "Abiogenesis: Solar Isotoma",
                "Rite of Progeniture: Tectonic Tide"
            ],
            "constellations": [
                "Flower of Eden",
                "Opening of Phanerozoic",
                "Grace of Helios",
                "Descent of Divinity",
                "Tide of Hadaen",
                "Dust of Purification"
            ],
            "passive_talents": [
                "Calcite Might",
                "Homuncular Nature",
                "Flash of Genius"
            ]
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:32.176Z",
        "request_id": "1faf47cc-0eb2-45c8-8655-889925c96c0f"
    },
    "status": "ok",
    "message": "Character retrieved",
    "success": true
}