Claves API y seguridad

Cómo enviar tu clave, usar más de una clave y permitir solo tus servidores.

Tu clave

Cada solicitud lleva la clave API de tu página de cuenta: clientKey en las solicitudes JSON, key en in.php y res.php. Una clave tiene 32 caracteres (0-9, a-f). Guárdala en tu servidor; cualquiera que tenga la clave puede gastar tu saldo.

POST /getBalance

{
  "clientKey": "YOUR_API_KEY"
}

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

Más claves

Puedes crear hasta 5 claves extra en la página de cuenta, por ejemplo una por servidor o proyecto. Comparten el saldo, muestran cuándo se usaron por última vez y se pueden desactivar una por una.

Lista de IP permitidas

Agrega hasta 20 direcciones IP en la página de cuenta y solo esas direcciones podrán usar tus claves. Las solicitudes desde otras direcciones reciben ERROR_IP_NOT_ALLOWED y no se cobran.

Error

{
  "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."
}

Llamadas desde un navegador

in.php y res.php agregan la cabecera CORS Access-Control-Allow-Origin: * cuando envías header_acao=1. Llamar a la API desde una página web pública expone tu clave, así que úsalo solo para tus propias herramientas.