Recursos Cross
Confira os principais recursos das nossas APIsDocumentação do
Você pode usar esta documentação para as seguintes unidades de negócio:
Última atualização em 14/03/2023
Endereços do usuário
Obter endereços do usuário
Para fazer uma chamada a essa API, você precisará de um token de acesso. Chamada:curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/addresses
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/145834937/addresses
Resposta:
{
"id": 145834937,
"user_id": "160252486",
"contact": null,
"phone": null,
"address_line": "Guatemala 5100",
"floor": null,
"apartment": null,
"street_number": "5100",
"street_name": "Guatemala",
"zip_code": "1000",
"city": -{
"id": "TUxBQlBBTDI1MTVa",
"name": "Palermo",
},
"state": -{
"id": "AR-C",
"name": "Capital Federal",
},
"country": -{
"id": "AR",
"name": "Argentina",
},
"neighborhood": -{
"id": null,
"name": null,
},
"municipality": -{
"id": null,
"name": null,
},
"search_location": -{
"state": -{
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal",
},
"city": -{
"id": "TUxBQ0NBUGZlZG1sYQ",
"name": "Capital Federal",
},
"neighborhood": -{
"id": "TUxBQlBBTDI1MTVa",
"name": "Palermo",
},
},
"types": -[
"default_selling_address",
"shipping",
],
"comment": "",
"geolocation_type": "RANGE_INTERPOLATED",
"latitude": -34.5834729,
"longitude": -58.4281022,
"status": "active",
"date_created": "2014-06-05T12:26:54.000-04:00",
"normalized": true,
"open_hours": -{
"on_holidays": -{
"hours": [
],
"status": "closed",
},
},
}
Especificação dos campos na resposta
Error Codes Reference
Campo | Sub-campo | Descrição |
---|---|---|
id | ID do endereço solicitado. | |
user_id | ID do usuário. | |
contact | Nome do proprietário das informações (usuário). | |
phone | Telefone do usuário. | |
address_line | Endereço completo do usuário (rua e, número). | |
floor | Andar do edifício, caso seja um apartamento. | |
apartment | Identificação do apartamento (número ou letra). | |
street_number | Número da rua do endereço citado em “address_line”. | |
street_name | Nome da rua do endereço citado em “address_line”. | |
zip_code | CEP. | |
city | Cidade na qual se encontra o endereço. | |
id | Identificador exclusivo da cidade (API principal do local). | |
name | Nome da cidade. | |
state | Estado/Província em que se encontra a cidade. | |
id | Identificador exclusivo do estado/província (API principal do local). | |
name | Nome do estado/província. | |
country | País em que se encontra o endereço. | |
id | Identificador exclusivo do país (API principal do local). | |
name | Nome do país. | |
neighborhood | Bairro associado ao endereço. | |
id | Identificador único do bairro. | |
name | Nome do bairro. | |
municipality | Município associado ao endereço. | |
id | Identificador exclusivo do município. | |
name | Nome do município. | |
search_location | Informações do endereço que será usado nas listagens de busca. | |
state | Estado/Província em que se encontra a cidade, no classificado. O id é associado à API de locais do classificado. | |
city | Cidade na qual se encontra o endereço, segundo o classificado. O id é associado à API de locais do classificado. | |
name | Nome do bairro. | |
neighbourhoood | Bairro onde se encontra o endereço, segundo o classificado. O id é associado à API de locais do classificado. | |
types | Especifique o tipo do domicílio. Valores possíveis:
|
|
comment | Comentários sobre as informações do endereço. | |
geolocation_type | Intervalo aproximado do endereço em questão. Conformeos parâmetros de latitude e longitude outorgados pelo Google Maps. | |
latitude | Latitude outorgada pelo Google Maps. | |
longitude | Longitude outorgada pelo Google Maps. | |
status | Estado do endereço. Valores possíveis: active ou inactive. | |
data_created | Data e hora na qual teve entrada. | |
normalized | Indica se os dados armazenados estão corretos. Caso não estejam corretos, será false. Valores possíveis: true, false. | |
open_hours | Horário de atendimento, caso o endereço pertença a uma loja. | |
on_holidays | Horário de atendimento especial durante as férias. Tem o subatributo hours. |
Próximo: Favoritos.