Autenticación
API Keys y scopes
Toda llamada va con su API Key en el header X-API-Key. Las keys se crean desde el dashboard y vienen en dos entornos.
Header obligatorio
Todas las requests a /api/v1/* llevan este header:
header
X-API-Key: automeli_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6- Las keys se crean desde app.automeli.com/dashboard/account?section=api-keys.
- El secreto se muestra una sola vez al crearla; si la pierde, puede re-verla desde la UI o regenerarla.
Hay dos entornos. El environment de la key determina el comportamiento del job — no se manda en el body.
automeli_live_*Producción. Publica en cuenta real de Mercado Libre. Consume créditos de publicación.
automeli_test_*Sandbox. Publica en cuenta test. Sin costo. Para validar su integración antes de tocar la cuenta real.
Trate la API Key como una contraseña. No la commitees a Git ni la pegues en canales públicos. Si se filtra, revóquela desde el dashboard y genere una nueva.
Al crear la key elige qué scopes habilitar. Si un endpoint requiere un scope que su key no tiene, recibe 403 E_AUTH_FORBIDDEN_SCOPE. Pida sólo los que su integración necesite.
ScopeEndpoints habilitados
products:writePOST /products, POST /products/jobs/{id}/retry, POST /products/jobs/{id}/cancel, POST /products/test/promoteproducts:readGET /products/jobs, GET /products/jobs/{id}, GET /products/testaccount:readGET /account, GET /account/tax-categoriesGET /ping no requiere scope — sirve para verificar la auth sin permisos adicionales.