Esse artigo está desatualizado. A API v2 também foi descontinuada.
Confira a documentação da v3 aqui.

Antes de começarmos a falar dos novos recursos, acredito que você deva estar se perguntando: E agora o que acontecerá com a versão antiga? Vai parar de funcionar? Tem algum prazo? Fique tranquilo! Abaixo esclareceremos suas dúvidas.

A API de Ofertas v1 foi descontinuada e não possui mais suporte da equipe técnica da Lomadee. É recomendável a migração para API v2. Porém mesmo não tendo mais suporte, a API v1 continuará no ar e não será desligada, portanto se sua aplicação estiver utilizando esta API a mesma não deverá ter problemas.

 

Quais são as novidades?

Basicamente, a API v2 sofreu um processo de re-arquitetura e rescrita técnica, porém manteve os mesmo conceitos da versão anterior. Nesta nova versão vários bugs conhecidos da versão anterior foram corrigidos e além disso esta melhor estruturada e organizada.

Além do já dito acima, as principais novidades ficam por conta dos novos recursos da API de Cupons que ganhou mais dois métodos: Busca de categorias e Busca de lojas. Com esses novos recursos agora é possível consultar as lojas que possuem cupons e as categorias de forma mais fácil e organizada.

Mas não fica só nisso, os recursos da API de ofertas tiveram uma repaginada geral e a principal mudança foi que o ID da oferta passa a ser o SKU da loja, portanto os IDs de ofertas da v1 não são compatíveis com os IDs de ofertas da nova API. Além disso, a busca de lojas ganhou uma informação muito pedida pelos developer, que é a comissão máxima da loja e a possibilidade de filtrar apenas as lojas que possuem ofertas.

 

O que não existe mais?

Os recursos viewSellerDetails e viewUserRatings, logo as informações de usuários que avaliaram lojas e produtos não será mais divulgada, porém os resumos de avaliações continuam presentes nos recursos de busca de lojas e busca de produtos.

 

De-para da v1 para v2

Recurso v1	Recurso equivalente v2	Observação
createLinks	API DeepLink	Foi acrescido a possibilidade de definir o domínio do deeplink e aumentou o limite de links por requisição para 100.
topOffers	Busca de Ofertas	Recurso: _bestsellers
findOfferList	Busca de Ofertas	O ID da oferta na v1 não é compatível com o ID da oferta na v2, pois agora o mesmo passa a ser o SKU da loja.
topProducts	Busca de Produtos	Recurso: _bestsellers
findProductList	Busca de Produtos	Os IDs de produtos continuam os mesmos.
viewProductDetails	Busca de Produtos	Os IDs de produtos continuam os mesmos.
viewUserRatings	Descontinuado
topCategories	Busca de Categorias	Recurso: _bestsellers
findCategoryList	Busca de Categorias	Os IDs das categorias continuam os mesmos.
sellers/lomadee	Busca de Lojas	Os IDs das lojas não são compatíveis com os IDs da v2, pois os IDs das lojas passam a ser os IDs da Lomadee (advertiserId).
viewSellerDetails	Descontinuado
coupons/lomadee	API de Cupons	Os IDs dos cupons continuam os mesmos.