TECNOPLAY STORE · Portal de desarrolladores

Documentación API pública

Esta API permite a agentes y aplicaciones consultar vitrinas, productos publicados y enviar solicitudes de cotización.

Referencia machine-readable

Descargar OpenAPI 3.1 en JSON

Endpoints principales

• GET /api/v1/public/web — listar vitrinas activas.
• GET /api/v1/public/web/by-host/{host} — resolver una vitrina por dominio.
• GET /api/v1/public/web/{slug} — obtener identidad y catálogo inicial.
• GET /api/v1/public/web/{slug}/productos — buscar y paginar productos.
• POST /api/v1/public/web/{slug}/solicitud — registrar una cotización o pedido.

Versionado y errores

v1 es la versión estable y forma parte de la ruta. La ruta histórica sin versión sigue disponible por compatibilidad, pero incluye Deprecation: true y un enlace successor-version. Los errores tienen ok: false, un code estable y un mensaje legible en message.

Límites de solicitudes

Lee RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset en cada respuesta. Si recibes 429 Too Many Requests, espera el valor de Retry-After antes de reintentar.

Acceso

Las consultas públicas no requieren API key. No asumas que el precio o la existencia están reservados: verifica la respuesta actual y confirma con TECNOPLAY STORE antes de completar una compra.

Ver información para agentes en Markdown