¿Quiénes somos?

En Mercado Libre tenemos una plataforma abierta que nos permite compartir con nuestra comunidad recursos públicos y privados para que puedan trabajar de la misma manera que lo hacemos nosotros, creando soluciones para vendedores.

Con nuestra API Restful podrás hacer llamadas a través del protocolo HTTPs utilizando los verbos GET, PUT, POST, DELETE y OPTIONS.

Nuestra API Restful es totalmente gratuita y fácil de monetizar, esto quiero decir que si creas una aplicación y detectamos que hay vendedores que la están utilizando, podrás iniciar el Proceso de Certificación y formar parte del App Store.

El App Store es un catálogo de aplicaciones disponible para que vendedores de diferentes países puedan encontrar soluciones certificadas que facilitan sus tareas diarias.

Contenidos

→Recursos públicos
→Recursos privados
   

Recursos públicos

Son aquellos que no requieren una credencial para ser consumidos. Son utilizados para obtener la información de una publicación, de nuestro árbol de categorías, de las preguntas que se realizan, entre otros.

Nota:
Existen situaciones donde el recurso puede ser público y privado a la vez, ya que tiene información abierta para todos y otra reservada que solo se pueden ver con autenticación.

Ejemplo:

  GET  https://api.mercadolibre.com/sites

Respuesta

[
  {
    "id": "MLU",
    "name": "Uruguay"
  },
  {
    "id": "MSV",
    "name": "El Salvador"
  },
  {
    "id": "MLV",
    "name": "Venezuela"
  },
  {
    "id": "MPA",
    "name": "Panamá"
  },
  {
    "id": "MGT",
    "name": "Guatemala"
  },
  {
    "id": "MRD",
    "name": "Dominicana"
  },
  {
    "id": "MBO",
    "name": "Bolivia"
  },
  {
    "id": "MCO",
    "name": "Colombia"
  },
  {
    "id": "MLB",
    "name": "Brasil"
  },
  {
    "id": "MEC",
    "name": "Ecuador"
  },
  {
    "id": "MHN",
    "name": "Honduras"
  },
  {
    "id": "MPE",
    "name": "Perú"
  },
  {
    "id": "MLA",
    "name": "Argentina"
  },
  {
    "id": "MLC",
    "name": "Chile"
  },
  {
    "id": "MCU",
    "name": "Cuba"
  },
  {
    "id": "MLM",
    "name": "Mexico"
  },
  {
    "id": "MCR",
    "name": "Costa Rica"
  },
  {
    "id": "MPY",
    "name": "Paraguay"
  },
  {
    "id": "MPT",
    "name": "Portugal"
  },
  {
    "id": "MNI",
    "name": "Nicaragua"
  }
]

Recursos privados

Existen casos en los que se deberá realizar un flujo de autenticación para que el usuario (vendedor), autorice a la aplicación para que pueda consumir su información privada. En este conjunto se encuentran las órdenes, los envíos, la mensajería, y los verbos POST y PUT de todos los endpoints.

Ejemplo:

 GET https://api.mercadolibre.com/orders/2053577644?access_token=$ACCESS_TOKEN
{
    "id": 2053577644,
    "date_created": "2019-06-13T09:20:02.000-04:00",
    "date_closed": "2019-06-13T09:20:08.000-04:00",
    "last_updated": "2019-06-13T09:20:08.000-04:00",
    "manufacturing_ending_date": null,
    "feedback": {
        "sale": null,
        "purchase": null
    },
    "mediations": [],
    "comments": null,
    "pack_id": 2000000101334825,
    "pickup_id": null,
    "order_request": {
        "return": null,
        "change": null
    },
    "fulfilled": null,
    "total_amount": 9.99,
    "paid_amount": 9.99,
    "coupon": {
        "id": null,
        "amount": 0
    },
    "expiration_date": "2019-07-11T09:20:08.000-04:00",
    "order_items": [
        
            "item": {
                "id": "MLB1226730704",
                "title": "Produto Teste - Não Ofertar",
                "category_id": "MLB11742",
                "variation_id": null,
                "seller_custom_field": null,
                "variation_attributes": [],
                "warranty": "12 months",
                "condition": "new",
                "seller_sku": null
            },
            "quantity": 1,
            "unit_price": 9.99,
            "full_unit_price": 9.99,
            "currency_id": "BRL",
            "manufacturing_days": null
        
    ],
    "currency_id": "BRL",
    "payments": [
        
            "id": 4863317779,
            "order_id": 2053577644,
            "payer_id": 419067349,
            "collector": {
                "id": 419059118
            },
            "card_id": null,
            "site_id": "MLB",
            "reason": "Produto Teste - Não Ofertar",
            "payment_method_id": "account_money",
            "currency_id": "BRL",
            "installments": 1,
            "issuer_id": null,
            "atm_transfer_reference": {
                "company_id": null,
                "transaction_id": null
            },
            "coupon_id": null,
            "activation_uri": null,
            "operation_type": "regular_payment",
            "payment_type": "account_money",
            "available_actions": [
                "refund"
            ],
            "status": "approved",
            "status_code": null,
            "status_detail": "accredited",
            "transaction_amount": 9.99,
            "taxes_amount": 0,
            "shipping_cost": 0,
            "coupon_amount": 0,
            "overpaid_amount": 0,
            "total_paid_amount": 9.99,
            "installment_amount": null,
            "deferred_period": null,
            "date_approved": "2019-06-13T09:20:07.000-04:00",
            "authorization_code": null,
            "transaction_order_id": null,
            "date_created": "2019-06-13T09:20:07.000-04:00",
            "date_last_modified": "2019-06-13T09:20:07.000-04:00"
        
    ],
    "shipping": {
        "id": 27987243797
    },
    "status": "paid",
    "status_detail": null,
    "tags": [
        "test_order",
        "pack_order",
        "paid"
    ],
    "buyer": {
        "id": 419067349,
        "nickname": "TT763866",
        "email": "ttest.6hqmq6+2-ogiydkmzvg43tmobx@mail.mercadolivre.com",
        "phone": {
            "area_code": "01",
            "extension": "",
            "number": "1111-1111",
            "verified": false
        },
        "alternative_phone": {
            "area_code": "",
            "extension": "",
            "number": ""
        },
        "first_name": "Test",
        "last_name": "Test",
        "billing_info": {
            "doc_type": "CPF",
            "doc_number": "78525276200"
        
    },
    "seller": {
        "id": 419059118,
        "nickname": "TETE8288849",
        "email": "ttest.hpz2z6q+2-ogiydkmzvg43tmobs@mail.mercadolivre.com",
        "phone": {
            "area_code": "01",
            "extension": "",
            "number": "1111-1111",
            "verified": false
        },
        "alternative_phone": {
            "area_code": "",
            "extension": "",
            "number": ""
        },
        "first_name": "Test",
        "last_name": "Test"
    },
    "taxes": {
        "amount": null,
        "currency_id": null
    
}

¿Qué estás esperando? Comienza ahora a crear tu aplicación leyendo la siguiendo documentación sobre Primeros pasos.

Forma parte de nuestra comunidad