Está viendo la documentación de la API v1 (versión anterior). v1 sigue funcionando sin cambios hasta el 31 de enero de 2027, fecha en la que se apagará. Las integraciones nuevas deben usar la API v2, que cubre todo lo de v1 con nombres limpios y paginación por cursor. Si ya integró con v1, la guía de migración lista las equivalencias campo por campo.

Empezar

Flujo test → live

Lo que diferencia a Automeli: publica primero en una cuenta de prueba, revisa qué quedó bien, y recién después promueve a su cuenta real reusando todo lo que ya se resolvió. Sin gastar créditos en lo que no está seguro.

Publica en prueba

POST /productskey test

Con una key test, Automeli publica en su cuenta de prueba de Mercado Libre. No consume créditos productivos.

Consulta qué quedó activo

GET /products/test

Revisa cuáles publicaciones quedaron status_meli=active y todavía no promoviste a real.

Promueve a real

POST /products/test/promotekey live

Con una key live, reutiliza categoría y precio ya resueltos en la prueba — no se vuelve a calcular nada.

Live en Mercado Libre

published_to_live: true

La publicación queda en su cuenta real. El producto de prueba se marca como promovido automáticamente.

1. Publica en prueba

Con una API Key automeli_test_* hace un POST /products. El test_mode lo decide el entorno de la key, no el body. Publica en su cuenta de prueba de Mercado Libre sin tocar créditos productivos.

shell

curl -X POST "https://api.automeli.com/api/v1/products" \
     -H "X-API-Key: automeli_test_..." \
     -H "Content-Type: application/json" \
     -d '{"items":[{"sku":"B003H03SDQ","auto_categorize":true}]}'

2. Consulta qué quedó activo

Después de que el job termina, lista lo que quedó publicado en prueba y todavía no promoviste, con GET /products/test. El filtro reproduce exactamente lo que ves en la web.

shell

curl "https://api.automeli.com/api/v1/products/test?status_meli=active&already_published=false" \
     -H "X-API-Key: automeli_test_..."

Cada producto trae lo que Automeli resolvió: category_id, price, currency, status_meli y published_to_live.

3. Promueve a real

Con una API Key automeli_live_* usa el atajo POST /products/test/promote. Toma los SKUs status_meli=active + already_published=0 y los publica en su cuenta real reusando la categoría y el precio ya resueltos en la prueba — la Lambda no vuelve a auto-categorizar ni recalcular.

shell

curl -X POST "https://api.automeli.com/api/v1/products/test/promote" \
     -H "X-API-Key: automeli_live_..." \
     -H "Content-Type: application/json" \
     -d '{}'

4. Live en Mercado Libre

Al completarse, el producto queda publicado en su cuenta real y su registro de prueba se marca published_to_live: true en la misma transacción del publicador — así deja de aparecer en el listado de pendientes. Sigue el avance con GET /products/jobs/{jobId} como cualquier otro job.

Por qué importa: no paga créditos productivos por publicaciones que todavía no validaste, y cuando promueve no se recalcula nada — el resultado en real es idéntico al que viste en prueba.