¿Qué es la API del catálogo de climahosteleria?
La API de climahosteleria es un servicio que climahostelería pone a su disposición para que su sitio web se mantenga actualizado automáticamente con nuestros productos.
¿Qué información está disponible para automatizar?
La información disponible para cada producto es la siguiente:
- id del producto
- referencia
- nombre
- precio (sin descuentos)
- moneda
- stock disponible
- URL con la imagen del producto
- Descripción corta
- Descripción larga
- Previsiones de entrada de stock
Actualmente, la información está disponible en idioma ESPAÑOL.
¿Cómo puedo integrar la API en mi sitio web?
Integrar el servicio es muy sencillo, tan solo tendrá que hacer una llamada GET al servicio y éste retornará un listado completo de los productos con toda su información. Todas las peticiones deben estar autenticadas. Si usted decide comprar el acceso a la API, se le proporcionarán unas claves de autenticación para poder acceder
¿Hay alguna limitación?
Solo podrá llamar al servicio una vez cada hora, por favor, vea los ejemplos para más información.
Peticiones API y posibles respuestas
Request http:
Headers:
Authorization: Basic base64(user:pass)
Params:
env: Entorno, valores admitidos: test y prod
lang: Idioma, valores admitidos: es
Endpoint:
https://api.climahosteleria.es/products.php
Response OK:
200 OK
{
"status": "ok",
"products": [
{
"id": 1,
"reference": "CH350",
"name": "Lavavasos Industrial con Cesta de 35x35cm de 400 x480 x650h mm VERONA CH350",
"price": 1215,
"price_unit": "€",
"stock": 23,
"image_url": "https://climahosteleria.es/img/p/2/9/9/9/2/29992.jpg",
"description": "![\"12.jpeg\"](\"https://climahosteleria.es/img/catalogo/12.jpeg\")
",
"description_short": null,
"orders": [
{
"date": "2023-01-31",
"quantity": 40
}
]
},
...
Response KO no auth:
400 invalid request:
{
"status": "error",
"message": "Unauthorized access, you're not allowed to access this resource so you're ip has been saved: 83.61.220.147"
}
Response KO, invalid language or env not present:
400 invalid request:
{
"status": "error",
"message": "env and lang are required, see the docs"
}
Response KO, unsupported language:
400 invalid request:
{
"status": "error",
"message": "lang not supported, only ES is supported"
}
Response KO, quota exceeded:
429 too many requests:
{
"status": "error",
"message": "Only one request per hour is allowed, wait for 59 minutes"
}
Ejemplo cURL entorno de test:
curl --location --request GET 'https://api.climahosteleria.es/products.php?env=test&lang=es' \
--header 'Authorization: Basic dGVzdDE6dGVzdDE='
Ejemplo PHP con cURL en entorno de test:
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.climahosteleria.es/products.php?env=test&lang=es',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => array(
'Authorization: Basic dGVzdDE6dGVzdDE='
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
