Consulta de usuários

Caso você já tenha conseguido registrar seu aplicativo, tenha feito a autenticação e gerado um usuário de teste, você deverá aprender a trabalhar com usuários (vendedores e compradores):

O tutorial abaixo o ensinará a realizar as seguintes ações:

Consultar meus dados pessoais

Se você já tiver feito login no Mercado Livre e tiver um token, poderá fazer a seguinte chamada para saber quais são as informações relacionadas a seu usuário:

Exemplo:

 curl  - X GET https://api.mercadolibre.com/users/me?access_token=$ACCESS_TOKEN

Resposta:

 {
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "country_id": "AR",
  "email": "test_user_50698062@testuser.com",
  "identification": {
    "type": "DNI",
    "number": "1111111"
  },
  "address": {
    "state": "AR-C",
    "city": "Palermo",
    "address": "Test Address 123",
    "zip_code": "1414"
  },
  "phone": {
    "area_code": "01",
    "number": "1111-1111",
    "extension": "",
    "verified": false
  },
  "alternative_phone": {
    "area_code": "",
    "number": "",
    "extension": ""
  },
  "user_type": "real_estate_agency",
  "tags": [
    "real_estate_agency",
    "test_user",
    "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "shipping_modes": [
    "custom",
    "not_specified"
  ],
  "seller_experience": "ADVANCED",
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "period": "historic",
      "total": 0,
      "completed": 0,
      "canceled": 0,
      "ratings": {
        "positive": 0,
        "negative": 0,
        "neutral": 0
      }
    }
  },
  "buyer_reputation": {
    "canceled_transactions": 0,
    "transactions": {
      "period": "historic",
      "total": null,
      "completed": null,
      "canceled": {
        "total": null,
        "paid": null
      },
      "unrated": {
        "total": null,
        "paid": null
      },
      "not_yet_rated": {
        "total": null,
        "paid": null,
        "units": null
      }
    },
    "tags": [
    ]
  },
  "status": {
    "site_status": "active",
    "list": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "buy": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "sell": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "billing": {
      "allow": true,
      "codes": [
      ]
    },
    "Mercado Pago_tc_accepted": true,
    "Mercado Pago_account_type": "personal",
    "Mercado Envios": "not_accepted",
    "immediate_payment": false,
    "confirmed_email": false,
    "user_type": "eventual",
    "required_action": ""
  },
  "credit": {
    "consumed": 100,
    "credit_level_id": "MLA1"
  }
}

Consultar dados de terceiros

Se você quiser consultar dados de usuários, terceiros poderá identificar dois níveis de informações: dados públicos, aqueles que podem ser encontrados navegando pelo perfil no Mercado Livre de qualquer outro usuário, Ex.: http://perfil.mercadolibre.com.ar/TETE2870021 e dados privados, que não poderão ser visualizados, a menos que você tenha permissões de usuário e um token válido para trabalhar em nome dele.
Em ambos os casos, a primeira coisa que você deverá conhecer é o id do usuário.

Obter o Id de usuário

Caso você não conheça o id, mas saiba o apelido e o site ao qual pertence um usuário, poderá obter seu Id fazendo a seguinte busca:

Chamada:

 https://api.mercadolibre.com/sites/{Site_id}/search?nickname={Nickname}

Exemplo:

 https://api.mercadolibre.com/sites/MLA/search?nickname=TETE2870021

Resposta:

 {
  "site_id": "MLA",
  "seller": {
    "id": 202593498,
    "seller_reputation": {
      "power_seller_status": null
    },
    "real_estate_agency": false,
    "car_dealer": false,
    "tags": [
    ]
  },
  "paging": {
    "total": 2,
    "offset": 0,
    "limit": 50
  },
  "results": [
    {
      "id": "MLA598903377",
      "site_id": "MLA",
      "title": "Test Item - Nao Ofertar",
      "subtitle": null,
      "seller": {
        "id": 202593498,
        "power_seller_status": null,
        "car_dealer": false,
        "real_estate_agency": false,
        "tags": [
        ]
      },
      "price": 200,
      "currency_id": "ARS",
      "available_quantity": 1,
      "sold_quantity": 0,
      "buying_mode": "buy_it_now",
      "listing_type_id": "bronze",
      "stop_time": "2016-03-06T17:16:49.000Z",
      "condition": "new",
      "permalink": "http://articulo.mercadolibre.com.ar/MLA-598903377-test-item-nao-ofertar-_JM",
      "thumbnail": "http://mla-s2-p.mlstatic.com/546311-MLA20539702714_012016-I.jpg",
      "accepts_Mercado Pago": true,
      "installments": {
        "quantity": 6,
        "amount": 42.33,
        "currency_id": "ARS"
      },
      "address": {
        "state_id": "AR-C",
        "state_name": "Capital Federal",
        "city_id": "",
        "city_name": "Palermo"
      },
      "shipping": {
        "free_shipping": false,
        "mode": "not_specified"
      },
      "seller_address": {
        "id": 175597910,
        "comment": "",
        "address_line": "",
        "zip_code": "",
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "state": {
          "id": "AR-C",
          "name": "Capital Federal"
        },
        "city": {
          "id": "",
          "name": "Palermo"
        },
        "latitude": -34.571148,
        "longitude": -58.423298
      },
      "attributes": [
      ],
      "original_price": null,
      "category_id": "MLA374515",
      "official_store_id": null
    },
    {
      "id": "MLA599121050",
      "site_id": "MLA",
      "title": "Item De Test - No Ofertar",
      "subtitle": null,
      "seller": {
        "id": 202593498,
        "power_seller_status": null,
        "car_dealer": false,
        "real_estate_agency": false,
        "tags": [
        ]
      },
      "price": 1000,
      "currency_id": "ARS",
      "available_quantity": 1,
      "sold_quantity": 0,
      "buying_mode": "buy_it_now",
      "listing_type_id": "bronze",
      "stop_time": "2016-03-07T20:12:41.000Z",
      "condition": "new",
      "permalink": "http://articulo.mercadolibre.com.ar/MLA-599121050-item-de-test-no-ofertar-_JM",
      "thumbnail": "http://mla-s2-p.mlstatic.com/493311-MLA20538550251_012016-I.jpg",
      "accepts_Mercado Pago": true,
      "installments": {
        "quantity": 6,
        "amount": 211.65,
        "currency_id": "ARS"
      },
      "address": {
        "state_id": "AR-C",
        "state_name": "Capital Federal",
        "city_id": "",
        "city_name": "Palermo"
      },
      "shipping": {
        "free_shipping": false,
        "mode": "not_specified"
      },
      "seller_address": {
        "id": 175597910,
        "comment": "",
        "address_line": "",
        "zip_code": "",
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "state": {
          "id": "AR-C",
          "name": "Capital Federal"
        },
        "city": {
          "id": "",
          "name": "Palermo"
        },
        "latitude": -34.571148,
        "longitude": -58.423298
      },
      "attributes": [
      ],
      "original_price": null,
      "category_id": "MLA90105",
      "official_store_id": null
    }
  ],
  "secondary_results": [
  ],
  "related_results": [
  ],
  "sort": {
    "id": "relevance",
    "name": "More relevant"
  },
  "available_sorts": [
    {
      "id": "price_asc",
      "name": "Lower price"
    },
    {
      "id": "price_desc",
      "name": "Higher price"
    }
  ],
  "filters": [
  ],
  "available_filters": [
    {
      "id": "category",
      "name": "Categories",
      "type": "text",
      "values": [
        {
          "id": "MLA1648",
          "name": "Computación",
          "results": 1
        },
        {
          "id": "MLA1430",
          "name": "Ropa y Accesorios",
          "results": 1
        }
      ]
    },
    {
      "id": "state",
      "name": "Location",
      "type": "text",
      "values": [
        {
          "id": "TUxBUENBUGw3M2E1",
          "name": "Capital Federal",
          "results": 2
        }
      ]
    },
    {
      "id": "accepts_Mercado Pago",
      "name": "Mercado Pago filter",
      "type": "boolean",
      "values": [
        {
          "id": "yes",
          "name": "With Mercado Pago",
          "results": 2
        }
      ]
    },
    {
      "id": "installments",
      "name": "Pago",
      "type": "text",
      "values": [
        {
          "id": "yes",
          "name": "Installments",
          "results": 2
        },
        {
          "id": "no_interest",
          "name": "Sin interés",
          "results": 0
        }
      ]
    },
    {
      "id": "condition",
      "name": "Condition filter",
      "type": "text",
      "values": [
        {
          "id": "new",
          "name": "New",
          "results": 2
        }
      ]
    },
    {
      "id": "buying_mode",
      "name": "Buying mode filter",
      "type": "text",
      "values": [
        {
          "id": "buy_it_now",
          "name": "Buy it now",
          "results": 2
        }
      ]
    },
    {
      "id": "has_pictures",
      "name": "Items with images filter",
      "type": "boolean",
      "values": [
        {
          "id": "yes",
          "name": "With pictures",
          "results": 2
        }
      ]
    }
  ]
}

Consultar informações públicas

Desse modo, você já conhece o Id do usuário, portanto pode realizar a chamada ao recurso users da seguinte maneira, obtendo as informações públicas do usuário que quiser:

Chamada:

 curl GET -X  https://api.mercadolibre.com/users/{User_id}

Exemplo:

 GET -X  https://api.mercadolibre.com/users/202593498

Resposta:

 {
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "country_id": "AR",
  "address": {
    "state": "AR-C",
    "city": "Palermo"
  },
  "user_type": "normal",
  "tags": [
    "normal",
    "test_user",
    "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "period": "historic",
      "total": 0,
      "completed": 0,
      "canceled": 0,
      "ratings": {
        "positive": 0,
        "negative": 0,
        "neutral": 0
      }
    }
  },
  "buyer_reputation": {
    "tags": [
    ]
  },
  "status": {
    "site_status": "active"
  }
}

Consultar informações privadas de um usuário que aceitou o uso de meu aplicativo

Para obter os dados privados de um usuário, você apenas deve adicionar o ACCESS_TOKEN do usuário ao final da chamada que fez anteriormente.

Chamada:

 curl GET -X  https://api.mercadolibre.com/users/{User_id}?access_token=¢ACCESS_TOKEN

Exemplo:

 curl GET -X  https://api.mercadolibre.com/users/202593498?access_token=¢ACCESS_TOKEN

Resposta:

 {
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "country_id": "AR",
  "email": "test_user_50698062@testuser.com",
  "identification": {
    "type": "DNI",
    "number": "1111111"
  },
  "address": {
    "state": "AR-C",
    "city": "Palermo",
    "address": "Test Address 123",
    "zip_code": "1414"
  },
  "phone": {
    "area_code": "01",
    "number": "1111-1111",
    "extension": "",
    "verified": false
  },
  "alternative_phone": {
    "area_code": "",
    "number": "",
    "extension": ""
  },
  "user_type": "normal",
  "tags": [
    "normal",
    "test_user",
    "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "shipping_modes": [
    "custom",
    "not_specified"
  ],
  "seller_experience": "ADVANCED",
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "period": "historic",
      "total": 0,
      "completed": 0,
      "canceled": 0,
      "ratings": {
        "positive": 0,
        "negative": 0,
        "neutral": 0
      }
    }
  },
  "buyer_reputation": {
    "canceled_transactions": 0,
    "transactions": {
      "period": "historic",
      "total": null,
      "completed": null,
      "canceled": {
        "total": null,
        "paid": null
      },
      "unrated": {
        "total": null,
        "paid": null
      },
      "not_yet_rated": {
        "total": null,
        "paid": null,
        "units": null
      }
    },
    "tags": [
    ]
  },
  "status": {
    "site_status": "active",
    "list": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "buy": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "sell": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "billing": {
      "allow": true,
      "codes": [
      ]
    },
    "Mercado Pago_tc_accepted": true,
    "Mercado Pago_account_type": "personal",
    "Mercado Envios": "not_accepted",
    "immediate_payment": false,
    "confirmed_email": false,
    "user_type": "eventual",
    "required_action": ""
  },
  "credit": {
    "consumed": 100,
    "credit_level_id": "MLA1"
  }
}

Como pode ver, dessa vez você obteve uma quantidade maior de dados do usuário: nome e sobrenome, e-mail, telefone, endereço etc. Solicitamos que não revele esses dados publicamente, pois isso pode prejudicar o usuário.

Atualizar dados de usuário

Você pode utilizar nossos recursos para atualizar suas informações de usuário depois do cadastramento. Isso é feito normalmente, porque nessa instância ninguém solicitará que você preencha seu endereço ou identificação pessoal, mas você deverá mantê-los completos, ou não poderá publicar produtos no Mercado Livre.
Para atualizar suas informações de usuário, veja o exemplo abaixo:

 curl -X PUT -H "Content-Type: application/json" -d
{
"identification_type": "DNI",
"identification_number": "33333333",
"address": "Triunvirato 5555",
"state":"AR-C",
"city":"Capital Federal",
"zip_dode": "1431",
"phone":{
        "area_code":"011",
        "number":"4444-4444",
        "extension":"001"
        },
"first_name":"Pedro",
"last_name": "Picapiedras",
"company":{
          "corporate_name":"Acme",
          "brand_name":"Acme Company"
          },
"Mercado Envios": "accepted"
}

https://api.mercadolibre.com/users/{User_id}?access_token= 

Parabéns! Você atualizou suas informações de usuário! Lembre-se de enviar somente os campos que quiser atualizar.

Usuario Vendedor com Mercado Pago obrigatório

Se você deseja que todas suas operações sejam exclusivamente a través de Mercado Pago deverão indicar na informação de seu usuário que só aceita essa modalidade. Deste jeito ficará desabilitado a opção “Acordar com o vendedor”.

PUT:

 curl -XPUT -H "Content-type: application/json" -d 

'{
    "reason": "by_user"
}'

https://api.mercadolibre.com/users/{user_id}/immediate_payment?access_token=$ACCESS_TOKEN

Se quiser deixar de aceitar como única opção Mercado Pago, pode apagar a marca do seguinte jeito:

 curl -XDELETE 

'https://api.mercadolibre.com/users/{user_id}/immediate_payment/by_user?access_token=$ACCESS_TOKEN

Códigos de erro comuns

206 – Partial content: muitas vezes, o recurso Users API retorna um código 206 – Partial content. Isso ocorrerá quando a solicitação de alguns dos dados falhar (por exemplo, reputação do usuário) informando que você receberá uma resposta incompleta.



Próximo:
Lojas oficiais.

Qualifique entre 1 e 5