Documentación técnica

API de Stock · MeinHaus Center

API de solo lectura para consultar el catálogo y el stock disponible en tiempo real de los productos habilitados para tu comercio.

1 Autenticación

Cada comercio recibe una API key única. Se envía en el header X-API-Key, o como parámetro ?api_key= si tu integración no puede setear headers.

bash

curl -H "X-API-Key: mhc_live_XXXXXXXXXXXX" "https://meinhauscenter.com/wp-json/mhc/v1/products"

2 Endpoints

Método	Ruta	Descripción
GET	`/products`	Lista de productos en JSON
GET	`/products.csv`	Misma información en CSV descargable
GET	`/categories`	Categorías/grupos disponibles para tu clave

3 Parámetros

Todos opcionales, se combinan libremente.

Parámetro	Valores	Efecto
`category`	`electrodomesticos` · `herramientas`	Filtra por grupo de categoría
`min_stock`	número entero	Solo productos con al menos esa cantidad
`in_stock_only`	`true`	Excluye los que están sin stock

4 Campos de cada producto

Campo	Tipo	Notas
`sku`	string	-
`name`	string	-
`description` / `short_description`	string	Sin HTML
`price` / `regular_price`	number	En `currency` (PYG)
`stock_quantity`	number \| null	null si el producto no tiene gestión de inventario activada. Nunca se inventa un número
`stock_status`	string	`instock` · `outofstock` · `onbackorder`
`stock_level`	string	`alto` · `medio` · `bajo` · `sin_stock` · `desconocido`
`stock_tracked`	boolean	Si `stock_quantity` es confiable
`images`	string[]	URLs
`categories`	string[]	Slugs de WooCommerce (subcategoría específica)
`group`	string \| null	`electrodomesticos` · `herramientas`, es lo que se usa en el parámetro `category`
`permalink`	string	Link a la ficha del producto
`updated_at`	string (ISO 8601)	-

5 Códigos de error

HTTP	Significado
401	Falta la API key o es inválida
403	La API key fue revocada
429	Se superó el límite de solicitudes (120 cada 5 minutos)

6 Ejemplos

bash

curl -H "X-API-Key: mhc_live_XXXX" "https://meinhauscenter.com/wp-json/mhc/v1/products?category=herramientas&min_stock=50"

javascript

const resp = await fetch("https://meinhauscenter.com/wp-json/mhc/v1/products", {
  headers: { "X-API-Key": "mhc_live_XXXX" }
});
const productos = await resp.json();

php

$ch = curl_init("https://meinhauscenter.com/wp-json/mhc/v1/products");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: mhc_live_XXXX"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$productos = json_decode(curl_exec($ch), true);