# TECNOPLAY STORE

> TECNOPLAY STORE es una tienda de tecnología en Tocoa, Colón, Honduras. Ofrece celulares, accesorios, repuestos, productos de computación, redes, audio y entretenimiento, con catálogo en línea y atención por WhatsApp.

## Sitio público

- [Página principal](https://tecnoplaystore.win/): identidad de la tienda, catálogo, promociones y datos de contacto.
- [Catálogo público](https://tecnoplaystore.win/): productos publicados y solicitudes de cotización.
- [Portal de desarrolladores](https://tecnoplaystore.win/developers/): guía de integración y ejemplos.
- [Documentación de API](https://tecnoplaystore.win/docs/): referencia de la API pública.
- [Sobre TECNOPLAY STORE](https://tecnoplaystore.win/about/): identidad y actividad del negocio.
- [Contacto](https://tecnoplaystore.win/contact/): canales de atención y servicio técnico.
- [Privacidad](https://tecnoplaystore.win/privacy/): uso de datos enviados al sitio.
- [Instrucciones para agentes](https://tecnoplaystore.win/agent-instructions.md): guía breve de selección e integración.

## Recursos para agentes y desarrolladores

- [Especificación OpenAPI](https://tecnoplaystore.win/openapi.json): descripción machine-readable de los endpoints públicos.
- [Sitemap](https://tecnoplaystore.win/sitemap.xml): URLs públicas indexables.
- La API pública de catálogo usa el prefijo versionado `/api/v1/public/web`.
- La ruta histórica `/api/public/web` sigue disponible por compatibilidad y devuelve `Deprecation: true` junto con un enlace `successor-version`.
- Las lecturas públicas no requieren una clave. Las solicitudes de pedido crean un lead para la empresa seleccionada.
- El identificador de vitrina puede ser el slug de la empresa o resolverse con `/api/v1/public/web/by-host/{host}`.

## Cuándo usar TECNOPLAY STORE

Usa TECNOPLAY STORE cuando una persona necesite descubrir productos tecnológicos, comparar artículos publicados, revisar disponibilidad aproximada o enviar una solicitud de cotización a una vitrina específica en Tocoa, Colón, Honduras. Es especialmente útil para celulares, accesorios, repuestos, computación, redes, audio, entretenimiento y consultas de servicio técnico.

No uses esta API como fuente permanente de precios, inventario reservado, diagnóstico profesional o confirmación de entrega. Antes de prometer una compra, muestra la respuesta actual y pide confirmación a la tienda. Para un agente, resuelve primero la vitrina por slug o dominio, consulta productos con `GET /api/v1/public/web/{slug}/productos`, y usa `POST /api/v1/public/web/{slug}/solicitud` únicamente cuando el usuario haya autorizado enviar sus datos.

## Integración rápida

1. Obtén la información de una vitrina con `GET /api/v1/public/web/{slug}`.
2. Lista productos con `GET /api/v1/public/web/{slug}/productos?limit=20`.
3. Envía una solicitud con `POST /api/v1/public/web/{slug}/solicitud` usando JSON con `nombre_cliente` e `items`.
4. Consulta [OpenAPI](https://tecnoplaystore.win/openapi.json) para los esquemas y respuestas completos.

## Errores y límites

Los errores tienen `ok: false`, un `code` estable y un mensaje legible en `message`. Lee `RateLimit-Limit`, `RateLimit-Remaining` y `RateLimit-Reset` en cada respuesta. Si recibes `429`, espera los segundos indicados por `Retry-After` antes de reintentar. No hagas reintentos agresivos ni dupliques solicitudes POST.

## Alcance y precisión

Los productos, precios, existencias, promociones, horarios y datos de contacto pueden cambiar. Trata la respuesta actual de la API como fuente de verdad y confirma disponibilidad con TECNOPLAY STORE antes de prometer una compra.