MercadoLibre Developers Conference MLA 2015

1. Leandro Bertalot
Novedades en la API
MercadoLibre Developer Relations

2. Developer Conference
● Cambios Generales
● Lo Nuevo en Marketplace
● Lo Nuevo en Clasificados
● Mejoras Dev Platform http://developers.mercadolibre.com
Agend
a

3. Developer Conference
● Items JSON Validation Improvements
● Listing Types and Item Upgrades
● Addresses API
● Revoke Access to Your Application
● Trends API
Cambios
Generales

4. Developer Conference
Cambios
Generales
Items JSON Validation Improvements
Example
{
"seller_id":,
"id",
"price":"p",
"seller_contact":null,
"pictures": [[1,2,3]]
}

5. Developer Conference
Output
{
"message":"body.invalid_field_types",
"error":"[
invalid property type: [price] expected Number but was String value: p,
invalid property type: [seller_contact] expected Map but was Null value: null,
invalid property type: [pictures[0]] expected Map but was JSONArray value: [1,
2, 3],
invalid property type: [seller_id] expected Number but was String value: id
]",
"status":400,
"cause":[]
}
Cambios
Generales
Items JSON Validation Improvements

6. Developer Conference
Get Listing types
https://api.mercadolibre.com/sites/MLA/listing_types
Cambios
Generales
Listing types and Item Upgrades

7. Developer Conference
Get Listing Types availables by User
https://api.mercadolibre.com/users/{Cust_id}/available_listing_types?category_id={Ca
tegory_id}&access_token=$ACCESS_TOKEN
Cambios
Generales
{
"category_id": "MLA3530",
"available": [
{
"site_id": "MLA",
"id": "gold",
"name": "Oro",
"remaining_listings": null
},
{
"site_id": "MLA",
"id": "bronce",
"name": "Bronce",
"remaining_listings": null
}
]
}
Listing types and Item Upgrades

8. Developer Conference
Get Available Listing Upgrades
https://api.mercadolibre.com/items/{Item_id}/available_upgrades?access_token=$AC
CESS_TOKEN
Cambios
Generales
Listing types and Item Upgrades
{
"category_id": "MLA3530",
"available": [
{
"site_id": "MLA",
"id": "gold_premium",
"name": "Oro Premium",
"remaining_listings": null
},
{
"site_id": "MLA",
"id": "gold_special",
"name": "Oro Profesional",
"remaining_listings": null
}
]
}

9. Developer Conference
Addresses API
Cambios
Generales
https://api.mercadolibre.com/users/{User_id}/addresses?access_token=XXXXXX
Get addresses from a User

10. Developer Conference
Revoke Access to Your APP
Cambios
Generales
curl -X DELETE -H "Content-Type:application/json"
https://api.mercadolibre.com/users/{cust_Id}/applications/{app_id}?access_token=
$ACCESS_TOKEN

11. Developer Conference
Trends
Cambios
Generales
https://tendencias.mercadolibre.com.ar

12. Developer Conference
Trends API
Cambios
Generales
By country By country and Category
curl -X GET
https://api.mercadolibre.com/sites/{site_id}/trends/s
earch
curl -X GET
https://api.mercadolibre.com/sites/{site_id}/trends/sear
ch?category={category_id}

13. Developer Conference
● Cambios Generales
● Lo Nuevo en Marketplace
● Lo Nuevo en Clasificados
● Mejoras Dev Platform http://developers.mercadolibre.com
Agend
a

14. Developer Conference
● Listing Prices Calculator
● New Feedback API
● API Improvements: Payment information in Orders
● Changes on Relistings
Lo Nuevo en Marketplace

15. Developer Conference
Listing prices calculator
https://api.mercadolibre.com/sites/MLA/listing_prices?price=5000&category_id=MLA3738
Get Listing Price
Lo Nuevo en Marketplace

16. Developer Conference
New Feedback API
curl -X POST -H "Content-Type: application/json" -d
'{
"fulfilled": false,
"rating": "neutral",
"message": "Operation not completed",
"reason": "THEY_DIDNT_ANSWER",
"restock_item": true,
"has_seller_refunded_money": false
}'
"https://api.mercadolibre.com/orders/{order_Id}/feedback?version=3.0&access_token=$ACCE
SS_TOKEN”
Post Feedback
Lo Nuevo en Marketplace

17. Developer Conference
New Feedback API
curl -X POST -H "Content-Type: application/json" -d'{
"reply":"COMMENT 2."
}'
"https://api.mercadolibre.com/feedback/{feedback_Id}/reply?version=3.0&
access_token=$ACCESS_TOKEN"
Post Reply
Change Feedback
curl -X PUT -H "Content-Type: application/json" -d '{
"fulfilled": true,
"rating": "positive",
"message": "It’s ok.",
}'
"https://api.mercadolibre.com//feedback/{feedback_id}?version=3.0&acce
ss_token=$ACCESS_TOKEN"
Lo Nuevo en Marketplace

18. Developer Conference
Payment information in Orders
Lo Nuevo en Marketplace
{
"id": 123123123,
…..
"payments": [
{
"id": 843847143,
"order_id": 881939618,
"payer_id": 132370569,
"collector": {
"id": 157251523
},
"card_id": null,
"site_id": "MCO",
"reason": null,
"payment_method_id": null,
"currency_id": "COP",
"installments": null,
"issuer_id": null,
"atm_transfer_reference": {
"company_id": null,
"transaction_id": null
},
…..
Response
…..
"coupon_id": null,
"activation_uri": null,
"available_actions": null,
"status": "approved",
"status_code": null,
"status_detail": null,
"transaction_amount": 124900,
"shipping_cost": 0,
"coupon_amount": 0,
"overpaid_amount": 0,
"total_paid_amount": 124900,
"date_created": "2014-09-
15T10:46:52.000-04:00",
"date_last_modified": "2014-09-
19T16:51:13.000-04:00"
}
]
…..
https://api.mercadolibre.com/orders/{Order_id}?access_token=ACCESS_TOKEN

19. Developer Conference
Lo Nuevo en Marketplace
…
"initial_quantity": 3,
"available_quantity": 3,
"sold_quantity": 1,
…
https://api.mercadolibre.com/items/MLA516387765
Relistings

20. Developer Conference
● Cambios Generales
● Lo Nuevo en Marketplace
● Lo Nuevo en Clasificados
● Mejoras Dev Platform
http://developers.mercadolibre.com
Agend
a

21. Developer Conference
● Classified Location Selection & Search
● Classified contacts API
● User Promotion Packs API
Lo Nuevo en Clasificados

22. Developer Conference
Classified Location Selection & Search
Lo Nuevo en Clasificados
https://api.mercadolibre.com/classified_locations/countries/AR
https://api.mercadolibre.com/classified_locations/neighborhoods/TUxBQlZJTDM5NTda

23. Developer Conference
Classified Location Selection & Search
Lo Nuevo en Clasificados
https://api.mercadolibre.com/sites/MLA/search?item_location=lat:-37.987148_-
30.987148,lon:-57.5483864_-50.5483864&category=MLA50278

24. Developer Conference
Classified Contacts API
Lo Nuevo en Clasificados

25. Developer Conference
Classified Contacts API
Lo Nuevo en Clasificados
https://api.mercadolibre.com/items/MLA508401142/contacts/questions?date_from=2014-08-
01T00:00:00.000-03:00&date_to=2015-03-02T23:59:59.999
Get Qty Questions by date on Item
https://api.mercadolibre.com/users/113601228/contacts/questions?date_from=2014
-08-01T00:00:00.000-03:00&date_to=2015-03-02T23:59:59.999
Get Qty Questions by date on User

26. Developer Conference
¿Y que pasó con “Ver Teléfono”?

27. Developer Conference
https://api.mercadolibre.com/items/MLA554327372/contacts/phone_views?date_from=2011-
08-01T00:00:00.000-03:00&date_to=2015-06-02T23:59:59.999
Get Qty Phone Views by date on Item
https://api.mercadolibre.com/users/113601228/contacts/phone_views?date_from
=2015-01-01T00:00:00.000-03:00&date_to=2015-02-02T23:59:5
Get Qty Phone Views by date on User
Classified Contacts API
Lo Nuevo en Clasificados

28. Developer Conference
Promotion Packs
Lo Nuevo en Clasificados
https://api.mercadolibre.com/categories/MLA1743/classifieds_promotion_packs
Get promotion packs

29. Developer Conference
Promotion Packs
Lo Nuevo en Clasificados
https://api.mercadolibre.com/users/{user_id}/cla
ssifieds_promotion_packs?access_token=$AC
CESS_TOKEN;
Get packages engaged by an user

30. Developer Conference
● Cambios Generales
● Lo Nuevo en Marketplace
● Lo Nuevo en Clasificados
● Mejoras Dev Platform
http://developers.mercadolibre.com
Agend
a

31. Developer Conference
Nuevo API-Directory
Mejoras Dev
Platform

32. Developer Conference
Nuevo API-Directory
Mejoras Dev
Platform

33. Developer Conference
Nuevo Foro Developers
Mejoras Dev
Platform
Al Foro
entrar tu
debes, si en
Jedi
convertirte
tu quieres

34. Developer Conference
Nuevo Foro Developers
Mejoras Dev
Platform

35. Developer Conference
Mejoras Dev
Platform
http://developers.mercadolibre.com/subscription/

36. Developer Conference
Mejoras Dev
Platform
Información sobre Eventos y Cambios en la API

37. Developer Conference
FIN
@LeandroBertalot