Novedades de la API - Leandro Bertalot

Leandro Bertalot

Novedades en la API

MercadoLibre Developer Relations

Developer Conference

● Cambios Generales

● Lo Nuevo en Marketplace

● Lo Nuevo en Clasificados

● Mejoras Dev Platform http://developers.mercadolibre.com

Agend

a


● Items JSON Validation Improvements

● Listing Types and Item Upgrades

● Addresses API

● Revoke Access to Your Application

● Trends API

Cambios

Generales

Developer ConferenceCambios

Generales

Items JSON Validation Improvements

Example

{

"seller_id":,

"id",

"price":"p",

"seller_contact":null,

"pictures": [[1,2,3]]

}


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


Get Listing types

https://api.mercadolibre.com/sites/MLA/listing_types

Cambios

GeneralesListing types and Item Upgrades

https://api.mercadolibre.com/sites/MLA/listing_types


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


}

]

}

Listing types and Item Upgrades

https://api.mercadolibre.com/users/


Get Available Listing Upgrades

https://api.mercadolibre.com/items/{Item_id}/available_upgrades?access_token=$AC

CESS_TOKEN

Cambios

GeneralesListing types and Item Upgrades

{

"category_id": "MLA3530",

"available": [

{

"site_id": "MLA",

"id": "gold_premium",

"name": "Oro Premium",


},

{

"site_id": "MLA",

"id": "gold_special",

"name": "Oro Profesional",


}

]

}

https://api.mercadolibre.com/items/


Addresses API

Cambios

Generales

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

Get addresses from a User

https://api.mercadolibre.com/users/


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


Trends

Cambios

Generales

https://tendencias.mercadolibre.com.ar

https://tendencias.mercadolibre.com.ar


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}





● Mejoras Dev Platform http://developers.mercadolibre.com

Agend

a


● Listing Prices Calculator

● New Feedback API

● API Improvements: Payment information in Orders

● Changes on Relistings

Lo Nuevo en Marketplace


Listing prices calculator

https://api.mercadolibre.com/sites/MLA/listing_prices?price=5000&category_id=MLA3738

Get Listing Price


https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000&category_id=MLA1744


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



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"



Payment information in OrdersLo 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

https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000&category_id=MLA1744



…

"initial_quantity": 3,

"available_quantity": 3,

"sold_quantity": 1,

…

https://api.mercadolibre.com/items/MLA516387765

Relistings





● Mejoras Dev Platform

http://developers.mercadolibre.com

Agend

a


● Classified Location Selection & Search

● Classified contacts API

● User Promotion Packs API

Lo Nuevo en Clasificados


Classified Location Selection & Search


https://api.mercadolibre.com/classified_locations/countries/AR

https://api.mercadolibre.com/classified_locations/neighborhoods/TUxBQlZJTDM5NTda

https://api.mercadolibre.com/classified_locations/countries/AR


Classified Location Selection & Search


https://api.mercadolibre.com/sites/MLA/search?item_location=lat:-37.987148_-

30.987148,lon:-57.5483864_-50.5483864&category=MLA50278


Classified Contacts API





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


¿Y que pasó con “Ver Teléfono”?


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



https://api.mercadolibre.com/users/113601228/contacts/phone_views?date_from=2014-08-01T00:00:00.000-03:00&date_to=2015-03-02T23:59:59.999


Promotion Packs


https://api.mercadolibre.com/categories/MLA1743/classifieds_promotion_packs

Get promotion packs


Promotion Packs


https://api.mercadolibre.com/users/{user_id}/cla

ssifieds_promotion_packs?access_token=$AC

CESS_TOKEN;

Get packages engaged by an user





● Mejoras Dev Platform

http://developers.mercadolibre.com

Agend

a


Nuevo API-Directory

Mejoras Dev

Platform


Nuevo Foro Developers

Mejoras Dev

Platform

Al Foro entrar tu

debes, si en Jedi

convertirte tu quieres


Nuevo Foro Developers

Mejoras Dev

Platform

Developer ConferenceMejoras Dev

Platformhttp://developers.mercadolibre.com/subscription/

Developer ConferenceMejoras Dev

PlatformInformación sobre Eventos y Cambios en la API

Developer ConferenceFIN

@LeandroBertalot

https://twitter.com/LeandroBertalot

Novedades de la API - Leandro Bertalot

Technology

Transcript of Novedades de la API - Leandro Bertalot