Direcciones del usuario

El siguiente documento tiene por objetivo presentar la Api Address, detallando los campos obtenidos en el response correspondiente a su consulta, junto con las posibles respuestas a los mismos.

Contenidos:

• URL
• Especificación de los campos en response

URL

Para realizar una llamada a esta API, necesitarás un access token. Llamada:

https://api.mercadolibre.com/users/$USER_ID/addresses?access_token=$ACCESS_TOKEN

Ejemplo:

https://api.mercadolibre.com/users/145834937/addresses?access_token=$ACCESS_TOKEN

Respuesta:

{
	"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",
    	},
	},
} 

Especificación de los campos en response

campo	Sub-campo	Descripción
id		ID de la dirección solicitada
user_id		ID del usuario
contact		Nombre de la persona propietaria de la información (usuario)
phone		Número telefónico del usuario
address_line		Domicilio completo del usuario (calle y número)
floor		Piso del edificio, en caso de ser el domicilio un departamento
apartment		Identificación del departamento (número o letra)
street_number		Número de la calle del domicilio citado en “address_line”
street_name		Nombre de la calle del domicilio citado en “address_line”
zip_code		Código postal
city		Ciudad en la que se encuentra el domicilio
	id	Identificador único de la ciudad (locations api core)
	name	Nombre de la ciudad
state		Estado/Provincia en la que se encuentra la ciudad.
	id	Identificador único del estado/provincia (locations api core)
	name	Nombre del estado/provincia
country		País en el que se encuentra la dirección
	id	Identificador único del país (locations api core)
	name	Nombre del país
neighborhood		Barrio asociado a la dirección
	id	Identificador único del barrio
	name	Nombre del barrio
municipality		Municipalidad asociada a la dirección
	id	Identificador único de la municipalidad
	name	Nombre de la municipalidad
search_location		Información del domicilio que se utilizará en los listados de búsqueda.
	state	Estado/Provincia en la que se encuentra la ciudad, en Classified.El id está asociado a la api de locations de classified.
	city	Ciudad en la que se encuentra el domicilio, según Classified. El id está asociado a la api de locations de classified.
	neighbourhood	Barrio en el que se encuentra el domicilio, según Classified. El id está asociado a la api de locations de classified.
types		Especifica el tipo de domicilio. Valores posibles: ● default_selling_address: domicilio de venta ● default_buying_address: domicilio de compra ● shipping: domicilio desde el cual se efectuarán los envíos ● billing: domicilio de facturación de MercadoLibre.
comment		Comentarios sobre la información del domicilio.
geolocation_type		Rango aproximado de la dirección en cuestión. Acorde a los parámetros de latitud y longitud otorgados por Google Maps.
latitude		Latitud otorgada por Google Maps.
longitude		Longitud otorgada por Google Maps.
status		Estado de la dirección. Valores posibles: active o inactive.
date_created		Fecha y hora en la cual fue dada de alta.
normalized		Indica si los datos almacenados son correctos. En caso de no serlos, será false. Valores posibles: true, false.
open_hours		Horario de atención, en caso de pertenecer la dirección a un comercio.
	on_holidays	Horario de atención especial para vacaciones. Posee el sub-atributo hours.

Siguiente: Marcadores