# Automeli API

> API pública de Automeli para publicar productos de Amazon en Mercado Libre. Publicaciones como jobs asíncronos; flujo recomendado test → promote → live.

- Base URL (v2, recomendada): https://api.automeli.com/api/v2
- Auth: header `X-API-Key` (prefijos `automeli_live_*` o `automeli_test_*`)
- Errores: RFC 7807 Problem Details; haga switch sobre el campo `code`.
- Paginación: por cursor en todos los listados (`next_cursor` / `has_more`).
- Estabilidad: beta.

## Guías
- [Bienvenida](https://www.automeli.com/api-docs): Qué es la API y cómo se organiza.
- [Registro y primera key](https://www.automeli.com/api-docs/onboarding): Paso 0: cuenta → conectar ML → API Key.
- [Quickstart](https://www.automeli.com/api-docs/quickstart): Su primer producto publicado en minutos.
- [Flujo test → live](https://www.automeli.com/api-docs/test-to-live): Publicar en prueba, revisar y promover a real.
- [Conectar con Claude (MCP)](https://www.automeli.com/api-docs/mcp): Servidor MCP remoto (https://mcp.automeli.com/mcp) para consultar la API desde Claude.
- [Paginación por cursor](https://www.automeli.com/api-docs/pagination): Cómo recorrer los listados de v2 (next_cursor / has_more).
- [Migrar desde v1](https://www.automeli.com/api-docs/migration): Tabla de equivalencias v1 → v2 y los cambios que rompen código.
- [API Keys y scopes](https://www.automeli.com/api-docs/auth): Autenticación, environments y permisos.
- [Errores](https://www.automeli.com/api-docs/errors): Catálogo RFC 7807, switch sobre `code`.
- [Rate limit](https://www.automeli.com/api-docs/rate-limit): Límites y headers X-RateLimit-*.

## Endpoints (v2)
- `GET /products` — Listar el catálogo de la cuenta real (scope products:read): https://www.automeli.com/api-docs/catalog#list
- `PATCH /products/sync-status` — Cambiar el estado de sincronización de un lote (scope products:write): https://www.automeli.com/api-docs/catalog#sync-status
- `POST /products` — Crear un job de publicación (scope products:write): https://www.automeli.com/api-docs/products
- `GET /products/test` — Listar productos en cuenta de prueba (scope products:read): https://www.automeli.com/api-docs/test-products#list
- `POST /products/test/promote` — Promover productos de prueba a la cuenta real (scope products:write): https://www.automeli.com/api-docs/test-products#promote
- `GET /products/jobs/{jobId}` — Consultar el estado de un job (scope products:read): https://www.automeli.com/api-docs/jobs#status
- `GET /products/jobs` — Listar jobs (scope products:read): https://www.automeli.com/api-docs/jobs#list
- `POST /products/jobs/{jobId}/retry` — Reintentar items fallidos de un job (scope products:write): https://www.automeli.com/api-docs/jobs#retry
- `POST /products/jobs/{jobId}/cancel` — Cancelar un job (scope products:write): https://www.automeli.com/api-docs/jobs#cancel
- `GET /account` — Info de la cuenta y créditos (scope account:read): https://www.automeli.com/api-docs/account#info
- `GET /account/tax-categories` — Categorías fiscales del seller (scope account:read): https://www.automeli.com/api-docs/account#tax-categories
- `GET /ping` — Verificar la API Key (health check autenticado): https://www.automeli.com/api-docs/auth/verify

## Recursos para máquinas
- OpenAPI 3.1 (v2): https://www.automeli.com/api-docs/openapi.json
- Catálogo de errores (JSON): https://www.automeli.com/api-docs/errors.json
- Referencia completa v2 (Markdown): https://www.automeli.com/api-docs/llms-full.txt
- Servidor MCP (Streamable HTTP, sin auth): https://mcp.automeli.com/mcp

## API v1 (versión anterior, en migración)
- v1 sigue operativa (base https://api.automeli.com/api/v1) pero está congelada y se apaga el 2027-01-31 (las respuestas v1 lo anuncian con los headers Deprecation y Sunset): los integradores nuevos deben usar v2.
- Doc v1: https://www.automeli.com/api-docs/v1
- OpenAPI 3.1 (v1): https://www.automeli.com/api-docs/v1/openapi.json
- Referencia completa v1 (Markdown): https://www.automeli.com/api-docs/v1/llms-full.txt
- Guía de migración v1 → v2: https://www.automeli.com/api-docs/migration