API-Schlüssel und Sicherheit

Wie Sie Ihren Schlüssel senden, mehrere Schlüssel verwenden und nur Ihre Server zulassen.

Ihr Schlüssel

Jede Anfrage enthält den API-Schlüssel von Ihrer Kontoseite: clientKey in JSON-Anfragen, key in in.php und res.php. Ein Schlüssel hat 32 Zeichen (0-9, a-f). Bewahren Sie ihn auf Ihrem Server auf; wer den Schlüssel hat, kann Ihr Guthaben ausgeben.

POST /getBalance

{
  "clientKey": "YOUR_API_KEY"
}

https://unlock-api.com/res.php?key=YOUR_API_KEY&action=getbalance&json=1

Weitere Schlüssel

Auf der Kontoseite können Sie bis zu 5 zusätzliche Schlüssel anlegen, zum Beispiel einen pro Server oder Projekt. Sie teilen sich das Guthaben, zeigen ihre letzte Verwendung an und lassen sich einzeln deaktivieren.

IP-Freigabeliste

Tragen Sie auf der Kontoseite bis zu 20 IP-Adressen ein, dann können nur diese Adressen Ihre Schlüssel verwenden. Anfragen von anderen Adressen erhalten ERROR_IP_NOT_ALLOWED und werden nicht berechnet.

Fehler

{
  "errorId": 1,
  "errorCode": "ERROR_IP_NOT_ALLOWED",
  "errorDescription": "Requests from this IP are not allowed. Add it to the IP allow list on your account page."
}

Aufrufe aus dem Browser

in.php und res.php fügen den CORS-Header Access-Control-Allow-Origin: * hinzu, wenn Sie header_acao=1 senden. Ein Aufruf der API von einer öffentlichen Webseite legt Ihren Schlüssel offen, verwenden Sie das also nur für Ihre eigenen Tools.