novedades de la api - leandro bertalot
TRANSCRIPT
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
Developer Conference
● 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]]
}
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
Developer Conference
Get Listing types
https://api.mercadolibre.com/sites/MLA/listing_types
Cambios
GeneralesListing types and Item Upgrades
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
Developer Conference
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",
"remaining_listings": null
},
{
"site_id": "MLA",
"id": "gold_special",
"name": "Oro Profesional",
"remaining_listings": null
}
]
}
Developer Conference
Addresses API
Cambios
Generales
https://api.mercadolibre.com/users/{User_id}/addresses?access_token=XXXXXX
Get addresses from a User
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
Developer Conference
Trends
Cambios
Generales
https://tendencias.mercadolibre.com.ar
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}
Developer Conference
● Cambios Generales
● Lo Nuevo en Marketplace
● Lo Nuevo en Clasificados
● Mejoras Dev Platform http://developers.mercadolibre.com
Agend
a
Developer Conference
● Listing Prices Calculator
● New Feedback API
● API Improvements: Payment information in Orders
● Changes on Relistings
Lo Nuevo en Marketplace
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
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
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
Developer Conference
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
Developer Conference
Lo Nuevo en Marketplace
…
"initial_quantity": 3,
"available_quantity": 3,
"sold_quantity": 1,
…
https://api.mercadolibre.com/items/MLA516387765
Relistings
Developer Conference
● Cambios Generales
● Lo Nuevo en Marketplace
● Lo Nuevo en Clasificados
● Mejoras Dev Platform
http://developers.mercadolibre.com
Agend
a
Developer Conference
● Classified Location Selection & Search
● Classified contacts API
● User Promotion Packs API
Lo Nuevo en Clasificados
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
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
Developer Conference
Classified Contacts API
Lo Nuevo en Clasificados
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
Developer Conference
¿Y que pasó con “Ver Teléfono”?
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
Developer Conference
Promotion Packs
Lo Nuevo en Clasificados
https://api.mercadolibre.com/categories/MLA1743/classifieds_promotion_packs
Get promotion packs
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
Developer Conference
● Cambios Generales
● Lo Nuevo en Marketplace
● Lo Nuevo en Clasificados
● Mejoras Dev Platform
http://developers.mercadolibre.com
Agend
a
Developer Conference
Nuevo API-Directory
Mejoras Dev
Platform
Developer Conference
Nuevo API-Directory
Mejoras Dev
Platform
Developer Conference
Nuevo Foro Developers
Mejoras Dev
Platform
Al Foro entrar tu
debes, si en Jedi
convertirte tu quieres
Developer Conference
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