api - visión general - melidevconf bsas

MercadoLibreDevelopers Conference

11 de Abril de 2013, Capital Federal

API - Visión GeneralPrincipios básicos de la plataforma

Darío Simonassi Jonathan Leibiusky@ldsimonassi @xetorthio

Gerente de Arquitectura

Gerente de Investigación y Desarrollo

Índice

● RESTFul API

● Conceptos Basicos

● Aplicación

● Notificaciones

● Versionamiento

● Testing

● Comunidad

Índice

● RESTFul API

● Conceptos Basicos

● Aplicación

● Notificaciones

● Versionamiento

● Testing

● Comunidad

RESTful API

RESTful API

api.mercadolibre.com/users/items

RESTful API - HTTPS

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

Obtener Crear Modificar Eliminar

RESTful API - HTTP Status

RESTful API - HTTP Status

RESTful API - HTTP Status

RESTful API - HTTP Status

RESTful API - HTTP Status

RESTful API - HTTP Status

RESTful API - JSON

RESTful API - JSONGET

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

{

"id": "MLA",

"name": "Argentina",

"country_id": "AR",

"sale_fees_mode": "not_free",

"mercadopago_version": 3,

"default_currency_id": "ARS",

"currencies": [...],

"immediate_payment": "optional",

"payment_method_ids": [...],

"categories": [...],

"settings": {...}

}

/items

/pictures

/users

/sites/MLA/categories

/orders

...

/sites/MLA/search

...

/orders

/bookmarks

...

API - Recursos

RESTful API - Resumiendo...

https://api.mercadolibre.com/items

/users

/countries

/countries/AR

RECURSO = URL

Índice

● RESTFul API

● Conceptos Basicos

● Aplicación

● Notificaciones

● Versionamiento

● Testing

● Comunidad

Conceptos Básicos - Recursos privados y públicos

Recursos privados y públicos

GET /users/66538485

Recursos privados y públicos

GET /users/me?access_token=...

Conceptos Básicos - Selection

Conceptos Básicos - Selection

Conceptos Básicos - Selection

title

picture

price

Conceptos Básicos - Selection

GET /items/MLB438904540

...

Conceptos Básicos - Selection

~ 2Kb

Conceptos Básicos - Selection

Conceptos Básicos - Selection

GET /items/MLB438904540?attributes=id,title,price,pictures

Conceptos Básicos - Selection

~ 340B

Conceptos Básicos - Selection

- 84%

Conceptos Básicos - Multiget

Conceptos Básicos - Multiget

Conceptos Básicos - Multiget

X 5

Conceptos Básicos - Multiget

GET /items/MLB438904539

GET /items/MLB438904540

GET /items/MLB438904541

....

5 x T

Conceptos Básicos - Multiget

/items?ids=MLB438904539,MLB438904540,MLB438904541,...

1 x T

Conceptos Básicos - Multiget

- 80%

Multiget + Selection

/items?ids=MLB438904539,MLB438904540,MLB438904541&attributes=id,title,price,pictures

Multiget + Selection

5 x más rápido10 x más corto

Accediendo a la API

Accediendo a la API

Índice

● RESTFul API

● Conceptos Basicos

● Aplicación

● Notificaciones

● Versionamiento

● Testing

● Comunidad

Aplicaciónapplications.mercadolibre.com

Índice

● RESTFul API

● Conceptos Basicos

● Aplicación

● Notificaciones

● Versionamiento

● Testing

● Comunidad

Notificacionesapplications.mercadolibre.com

Índice

● RESTFul API

● Conceptos Basicos

● Aplicación

● Notificaciones

● Versionamento

● Testing

● Comunidad

Versionamiento

api.mercadolibre.com v1.api.mercadolibre.com

Versionamiento

Índice

● RESTFul API

● Conceptos Basicos

● Aplicación

● Notificaciones

● Versionamiento

● Testing

● Comunidad

POST /users/test_user?access_token=...{ "site_id":"MLA"}

Response:{

"id":120506781,"nickname":"TEST0548","password":"qatest328","site_status":"active"

}

Testing

Índice

● RESTFul API

● Conceptos Basicos

● Aplicación

● Notificaciones

● Versionamiento

● Testing

● Comunidad

developers.mercadolibre.com

github.com/mercadolibre(js-sdk, java-sdk, net-sdk, php-sdk)

@melidevelopers

#meli@irc.freenode.net

Comunidad

Muchas gracias!

Jonathan Leibiusky@xetorthio

Darío Simonassi@ldsimonassi