Buscar Productos / search

🔍 Buscar Producto

Buscar Producto por SKU, Nombre o ID

Este endpoint permite buscar productos utilizando uno o varios de los siguientes parámetros: SKU, nombre o ID. Retorna información básica del producto, incluyendo título, precio, stock, imagen y URL.

---

📍 Endpoint

GET /api/search

URL completa de ejemplo:

http://tudominio.com/api/search?apikey=tu_clave_api&sku=ABC123

🧾 Parámetros (Query String)

Parámetro	Tipo	Requerido	Descripción
apikey	string	✅	Clave API para autorizar la solicitud
sku	string	❌	SKU del producto a buscar
name	string	❌	Título o parte del nombre del producto
id	int	❌	ID numérico del producto

Al menos uno de los parámetros sku, name o id debe estar presente.

📤 Respuestas

🟢 200 OK

Descripción: Uno o más productos encontrados.

{
  "success": true,
  "products": [
    {
      "id": "7705",
      "sku": "TEC141",
      "slug": "teclado-logitech-k780-bluetooth-espanol",
      "price": "6350",
      "discount_rate": "0",
      "stock": "1",
      "currency": "USD",
      "title": "Teclado Logitech K780 bluetooth español",
      "description": "un tecladazo",
      "final_price": "63.50",
      "product_url": "http://localhost:8080/teclado-logitech-k780-bluetooth-espanol",
      "image_url": "http://localhost:8080/uploads/images/202408/img_x300_66c41bf5beabd5-23352661-17577284.jpg"
    }
  ]
}

🟡 400 Bad Request

Descripción: No se proporcionó ningún parámetro de búsqueda.

{
  "error": "At least one search parameter is required"
}

🔴 403 Forbidden

Descripción: La clave API proporcionada no es válida.

{
  "error": "Invalid API Key"
}

🔴 404 Not Found

Descripción: No se encontraron productos que coincidan con los criterios.

{
  "error": "No products found"
}

📝 Notas

• Puedes buscar por sku, name, id, o combinarlos.

• La respuesta incluye:

  • product_url: Enlace público al producto

  • image_url: URL absoluta de la imagen principal