Integración con API de Mercado Libre

Quick Start

1. Identificar Caso de Uso

2. Flujo de Autenticación

flowchart LR
    A[Registrar App] --> B[Redirigir Usuario]
    B --> C[Capturar Code]
    C --> D[POST /oauth/token]
    D --> E[access_token]
    E --> F{¿Expiró?}
    F -->|Sí| G[Refresh Token]
    G --> E
    F -->|No| H[Usar API]

Detalles completos: oauth-guide.md

3. Endpoints Básicos

# Búsqueda (sin auth)
GET https://api.mercadolibre.com/sites/MLA/search?q=notebook

# Item específico (sin auth)
GET https://api.mercadolibre.com/items/{ITEM_ID}

# Operaciones autenticadas (requieren Bearer token)
GET https://api.mercadolibre.com/orders/search?seller={ID}
POST https://api.mercadolibre.com/items
POST https://api.mercadolibre.com/answers

Ejemplos completos: code-examples.md

Troubleshooting Rápido

Soluciones detalladas: error-handling.md

Sites Disponibles

Webhooks

Topics Disponibles

• •orders_v2 - Cambios en órdenes
• •items - Cambios en publicaciones
• •questions - Nuevas preguntas
• •messages - Mensajes de compradores
• •claims - Reclamos

Setup Rápido

1. •Configurar endpoint HTTPS en tu servidor
2. •Registrar URL en app: PUT /applications/{APP_ID}
3. •Suscribirse a topics: POST /applications/{APP_ID}/subscriptions

Ejemplos completos: code-examples.md#webhooks

Constraints

Seguridad

• •Nunca exponer client_secret o access_token en código versionado
• •Usar variables de entorno para credenciales
• •HTTPS obligatorio para redirect URIs y webhooks

Operaciones Críticas

[!CAUTION] Confirmar antes de:

• •Pausar/eliminar publicaciones masivamente
• •Cambiar precios de múltiples items
• •Cancelar órdenes

Rate Limits

• •Consultas públicas: ~10,000/día
• •Implementar exponential backoff para 429
• •Preferir webhooks sobre polling

Resources

• •Base URL: https://api.mercadolibre.com
• •Docs oficiales: https://developers.mercadolibre.com/
• •SDKs: npm mercadolibre, Maven (oficial), pip (no oficial)

Referencias Detalladas

• •OAuth Guide - Flujo completo de autenticación
• •Code Examples - Ejemplos en bash, Node.js, Python
• •Error Handling - Tabla de errores y soluciones