Autenticación

Obteniendo las credenciales de acceso

Para conectar con la API necesitarás obtener previamente las credenciales (AccessId / AccessKey). Éstas están disponibles en tu panel de usuario cuando has contratado un servicio que incluye acceso API.

Las credenciales deben ir includas en cada una de las peticiones a la API en la cabecera Authorization de la forma Authorization: Basic <base64(AccessId:AccessKey)>.

Un ejemplo de credenciales (no válidas) son:

  • Access Id: LB032F56E8
  • Access Key: 327bba88026f13c0ff8c503157ed0fe540cfe32d

Límite de peticiones

Además del límite de peticiones mensual, su plan contratado tiene asociado un número máximo de consultas por hora y minuto, con el objetivo de evitar abusos y que otros usuarios se vean afectados.

Si necesitas aumentar este límite, mándanos un email a contacto@libreborme.net.

Comprobando la validez de su token

Desde la terminal puede ejecutar el siguiente comando para comprobar si su token es válido:

http -a LB032F56E8:327bba88026f13c0ff8c503157ed0fe540cfe32d https://api.librebor.me/v2/

Si la respuesta devuelve el código HTTP 401, entonces el token no es válido. Si por el contrario la respuesta obtenida tiene el código HTTP 200 y además es parecida a la siguiente, ¡enhorabuena! ya puede comenzar a usar la API.

Welcome to LibreBOR API, <name>!
For more information, checkout https://docs.librebor.me/

Remaining requests:
 Individual requests: 500

En la siguiente sección conocerá detalladamente cuáles son los tipos de peticiones permitidas.