# RM Ecommerce API

> API REST v1 de RM, una plataforma de ecommerce multi-tenant. Cada llave de API (`Authorization: Bearer rk_...`) pertenece a una tienda y
> solo ve sus datos. Permisos por área (`read_`/`write_` de products, inventory, prices, customers, orders, integrations), paginación por
> cursor, `Idempotency-Key` en pedidos y pagos, 600 peticiones por minuto por llave y webhooks salientes firmados con HMAC-SHA256.

## Documentación

- [Documentación en línea](https://retail-s.online/docs/): introducción, autenticación, recursos con ejemplos curl, webhooks, errores y guía de conector.
- [Contexto y prompts para IA](https://retail-s.online/docs/api-ia.md): contexto compacto de la API y prompts listos para implementar conectores.
- [Referencia completa](https://retail-s.online/docs/api.md): reglas de negocio de cada recurso, en Markdown.

## Contrato

- [OpenAPI 3.1](https://retail-s.online/docs/openapi.json): todas las rutas, parámetros, cuerpos, permisos y errores.
- [Colección de Postman](https://retail-s.online/docs/rm-api.postman_collection.json) y [environment](https://retail-s.online/docs/rm-api.postman_environment.json): variables `base_url` y `api_key`.

## Optional

- Base de la API: `https://retail-s.online/api/v1` (la ruta de cada operación se agrega a esa base).