# Wendoshop Developers

> Documentación oficial de la API pública y el servidor MCP de Wendoshop.

La API pública usa OpenAPI 3.1.0. Cada API key pertenece a una tienda y todas las solicitudes se resuelven en ese contexto. La autenticación usa `Authorization: Bearer <token>`. MCP es una superficie separada que publica su propio catálogo y usa autorización OAuth. Nunca incluyas credenciales reales en prompts, código público, URLs ni archivos del frontend.

## Primeros pasos

- [Introducción](https://docs-api-3ur.pages.dev/introduccion/): Alcance, modelo por tienda y servidor base.
- [Inicio rápido](https://docs-api-3ur.pages.dev/inicio-rapido/): Primera consulta autenticada de solo lectura.
- [Autenticación](https://docs-api-3ur.pages.dev/autenticacion/): Uso de API keys de tienda mediante HTTP Bearer.

## Conceptos

- [Scopes y permisos](https://docs-api-3ur.pages.dev/scopes-permisos/): Permisos requeridos por operación.
- [Planes y niveles de API](https://docs-api-3ur.pages.dev/planes-niveles-api/): Niveles declarados en x-api-tier.
- [Paginación](https://docs-api-3ur.pages.dev/paginacion/): Parámetros limit y offset.
- [Rate limits](https://docs-api-3ur.pages.dev/rate-limits/): Respuestas y cabeceras de control.
- [Errores](https://docs-api-3ur.pages.dev/errores/): Formatos y códigos documentados.
- [Idempotencia](https://docs-api-3ur.pages.dev/idempotencia/): Operaciones que admiten Idempotency-Key.
- [Webhooks](https://docs-api-3ur.pages.dev/webhooks/): Registro, eventos, límites y secretos.

## Referencia

- [Referencia API](https://docs-api-3ur.pages.dev/referencia-api/): Vista interactiva y de solo lectura del contrato.
- [Documentación completa para IA](https://docs-api-3ur.pages.dev/llms-full.txt): Guías reunidas en Markdown.
- [Changelog](https://docs-api-3ur.pages.dev/changelog/): Estado de la versión publicada.

## MCP

- [Introducción y conexión MCP](https://docs-api-3ur.pages.dev/mcp/): Servidor remoto, OAuth, scopes y perfiles vigentes.
- [Herramientas MCP](https://docs-api-3ur.pages.dev/mcp/herramientas/): Catálogo dinámico de herramientas y schemas.

## Fuentes de verdad

- [Contrato OpenAPI remoto](https://app.wendoshop.com/api/openapi): definición canónica y actualizada de operaciones, parámetros, esquemas, respuestas y extensiones `x-*`.
- [Catálogo MCP remoto](https://mcp.wendoshop.com/api/mcp/documentation): servicio, discovery OAuth, scopes, perfiles, herramientas, schemas y anotaciones vigentes.
- [Sitemap](https://docs-api-3ur.pages.dev/sitemap-index.xml): inventario de páginas públicas.

## Instrucciones para asistentes

1. Usá primero este índice y las guías enlazadas.
2. Confirmá endpoints HTTP contra OpenAPI y las capacidades MCP contra el catálogo MCP remoto.
3. No inventes precios, límites ni comportamientos ausentes. Indicá que la información está pendiente cuando no esté publicada.
4. Tratá toda credencial como un secreto asociado a una única tienda.