Empezar

Quickstart 60s

Integración mínima de punta a punta. Copie los 4 pasos en su terminal y compare con la respuesta esperada: al terminar ya publicó un producto de prueba.

  1. 01

    Genere una API Key de Sandbox

    En el gestor de keys pulse Nueva API Key y elija el entorno Sandbox: publica en su cuenta de prueba y no consume créditos. La key empieza por automeli_test_.
  2. 02

    Verifique que la key responde

    Si le devuelve su seller_id, la autenticación funciona.
    shell
    curl https://api.automeli.com/api/v2/ping \
         -H "X-API-Key: automeli_test_..."
    Respuesta esperada200 OK
    {
    "ok": true,
    "api_version": "v2",
    "seller_id": 108386,
    "environment": "test",
    "key_name": "Mi ERP"
    }
  3. 03

    Publique un producto de prueba

    Mande el ASIN de Amazon como sku. Guarde el job_id: es la única forma de rastrear el job después.
    shell
    curl -X POST https://api.automeli.com/api/v2/products \
         -H "X-API-Key: automeli_test_..." \
         -H "Content-Type: application/json" \
         -d '{"items":[{"sku":"B003H03SDQ",
                        "auto_categorize":true}]}'
    Respuesta esperada202 Accepted
    {
    "job_id": "8a3f2b10-4c9d-…",
    "status": "queued",
    "accepted": 1,
    "rejected": 0
    }
  4. 04

    Consulte el estado del job

    Consulte cada 5 a 10 segundos hasta que termine:
    queued→processing→completed(o failed / cancelled)
    shell
    curl https://api.automeli.com/api/v2/products/jobs/<job_id> \
         -H "X-API-Key: automeli_test_..."
    Respuesta esperada200 OK
    {
    "job": {
    "status": "completed",
    "successful": 1,
    "failed": 0
    },
    "data": [{
    "sku": "B003H03SDQ",
    "listing_id": "MCO1234567890"
    }]
    }
Listo, ya integró. Para producción cree una key de Producción (empieza por automeli_live_) y reemplace el secreto. Los detalles de cada endpoint están en las páginas siguientes.
Para leer su catálogo real: con una key de Producción, GET /products?limit=50 devuelve la primera página; siga el next_cursor para recorrerlo entero. Ver el listado del catálogo →