Clash-of-Clans-API-Schlüssel
Viele Bereiche (CWL, Kriegsdaten, Spieler-Profile, Bestenlisten) lesen live aus der offiziellen Clash-of-Clans-API. Dafür braucht dein Server einen API-Schlüssel.
Schlüssel anlegen und hinterlegen
- Konto auf
developer.clashofclans.comanlegen und dort einen Key erstellen. - Als erlaubte IP-Adresse die Server-IP des Panels eintragen — sie steht im Panel unter Einstellungen → Allgemein → Supercell-API-Key direkt am Eingabefeld.
- Den Key an derselben Stelle einfügen und Speichern.
Die Server-IP steht mit Kopier-Knopf an beiden Stellen: im Einrichtungs-Assistenten (Schritt „API-Key") und später in den Einstellungen. Beides schreibt in dasselbe Feld — du musst den Key also nur einmal hinterlegen, nicht zweimal. Ein neu gespeicherter Key ersetzt den alten.
Supercell bindet den Key an IP-Adressen, nicht an Domains. Trage dort ausschließlich die angezeigte Server-IP ein. Kommt von der Spiel-API bei jeder Anfrage ein Fehler, ist fast immer eine falsche oder fehlende IP am Key die Ursache.
Was ohne Schlüssel passiert
Ohne Schlüssel bleiben API-Bereiche leer und sagen das auch ehrlich — es wird nichts geraten oder aus alten Daten „gefüllt".
- Einen Clan hinzufügen lehnt das Panel mit dem Hinweis ab, erst den API-Key zu hinterlegen — ohne Key lässt sich der Clan-Tag nicht nachschlagen.
- Die Clan-Verifizierung und die CWL-Anmeldungen (einzeln wie in Masse) verlangen den Key ebenfalls, weil sie Spieler- und Clan-Daten gegenlesen.
- CWL, CK-Leistung und die Bestenlisten zeigen statt Zahlen einen Hinweis, dass der Key fehlt, mit Link zu den Einstellungen.
- Dashboard und Clan-Übersicht lassen die betroffenen Blöcke leer — keine Platzhalter-Zahlen.
Globaler Schlüssel als Rückfall
Der Betreiber kann im Developer-Portal einen globalen Key hinterlegen. Das Panel nimmt immer zuerst den Key deines Servers; nur wenn keiner da ist, greift der globale als Rückfall. Deshalb kann der Schritt „Supercell-API-Key hinterlegen" in den Ersten Schritten bereits erledigt sein, obwohl in den Einstellungen noch kein „Hinterlegt" steht — dann läuft dein Server auf dem globalen Key. Aus demselben Grund können die Key-Hinweise in CWL und CK-Leistung stehen bleiben, obwohl die Daten laden: sie fragen nur nach deinem eigenen Key.
Ein eigener Key ist trotzdem die bessere Wahl: das Anfrage-Limit deiner Clan-Familie hängt dann an deinem Key allein und nicht am geteilten.
Grenzen
- Beim Speichern prüft das Panel nur, dass überhaupt etwas eingetragen ist. Der Knopf im Einrichtungs-Assistenten heißt „Speichern & prüfen" — ob der Key wirklich funktioniert, zeigt sich aber erst bei der ersten echten Abfrage, etwa beim Hinzufügen eines Clans.
- Der Key wird nur serverseitig gespeichert und im Browser nie wieder angezeigt; sichtbar ist ausschließlich, dass einer hinterlegt ist.
- Der Ingame-API-Token für den Besitz-Nachweis eines Clans ist ein anderer Token: er kommt aus den Spiel-Einstellungen, wird einmalig geprüft und nicht gespeichert (siehe Verknüpfung).
- Steht das Kriegsprotokoll eines Clans auf privat, liefert die Spiel-API dazu nichts. Das ist eine Clan-Einstellung, kein Fehler des Keys — die betroffenen Auswertungen bleiben leer.