api - overview

MercadoLivreDevelopers Conference

31 de Outubro de 2012, São Paulo

API - Visão geralPrincípios básicos da plataforma, formatos, funções e padrões da plataforma

Darío Simonassi Jonathan Leibiusky@ldsimonassi @xetorthio

Índice

● RESTFul API

● Conceitos Ba ́sicos

● Aplicaçao

● Notificações

● Versionamento

● Testing

● Comunidade

Índice

● RESTFul API

● Conceitos Ba ́sicos

● Aplicaçao

● Notificações

● Versionamento

● Testing

● Comunidade

RESTful API

RESTful API

api.mercadolibre.com/users/items

RESTful API - HTTPS

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

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 - JSON

GET

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

{

"id": "MLB",

"name": "Brasil",

"country_id": "BR",

"sale_fees_mode": "not_free",

"mercadopago_version": 3,

"default_currency_id": "BRL",

"currencies": [...],

"immediate_payment": "optional",

"payment_method_ids": [...],

"categories": [...],

"settings": {...}

}

/items

/pictures

/users

/sites/MLB/categories

/orders

...

/sites/MLB/search

...

/orders

/bookmarks

...

API - Recursos

RESTful API - Resumindo...

https://api.mercadolibre.com

/items

/users

/countries

/countries/BR

RECURSO = URL

Índice

● RESTFul API

● Conceitos Ba ́sicos

● Aplicaçao

● Notificações

● Versionamento

● Testing

● Comunidade

Conceitos Básicos - Recursos privados e públicos

Recursos privados e públicos

GET /users/66538485

Recursos privados e públicos

GET /users/me?access_token=...

Conceitos Básicos - Selection

Conceitos Básicos - Selection

Conceitos Básicos - Selection

title

picture

price

Conceitos Básicos - Selection

GET /items/MLB438904540

...

Conceitos Básicos - Selection

~ 2Kb

Conceitos Básicos - Selection

Conceitos Básicos - Selection

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

Conceitos Básicos - Selection

~ 340B

Conceitos Básicos - Selection

- 84%

Conceitos Básicos - Multiget

Conceitos Básicos - Multiget

Conceitos Básicos - Multiget

X 5

Conceitos Básicos - Multiget

GET /items/MLB438904539

GET /items/MLB438904540

GET /items/MLB438904541

....

5 x T

Conceitos Básicos - Multiget

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

1 x T

Conceitos Básicos - Multiget

- 80%

Multiget + Selection

/items?ids=MLB438904539,MLB438904540,MLB438904541

&attributes=id,title,price,pictures

Multiget + Selection

5 x mais rápido10 x mais curto

Accesando a API

Accesando a API

Índice

● RESTFul API

● Conceitos Ba ́sicos

● Aplicaçao

● Notificações

● Versionamento

● Testing

● Comunidade

Aplicações

applications.mercadolibre.com

Índice

● RESTFul API

● Conceitos Ba ́sicos

● Aplicaçao

● Notificações

● Versionamento

● Testing

● Comunidade

Notificações

applications.mercadolibre.com

Índice

● RESTFul API

● Conceitos Ba ́sicos

● Aplicaçao

● External Feed

● Versionamento

● Testing

● Comunidade

Versionamento

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

Versionamento

Índice

● RESTFul API

● Conceitos Ba ́sicos

● Aplicaçao

● Notificações

● Versionamento

● Testing

● Comunidade

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

Response:{

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

}

Testing

Índice

● RESTFul API

● Conceitos Ba ́sicos

● Aplicaçao

● Notificações

● Versionamento

● Testing

● Comunidade

developers.mercadolibre.com

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

@melidevelopers

#meli@irc.freenode.net

Comunidade

Muito Obrigado!

Jonathan Leibiusky@xetorthio

Darío Simonassi@ldsimonassi