Download the PHP package dsc/mercado-livre without Composer

On this page you can find all versions of the php package dsc/mercado-livre. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package mercado-livre

Biblioteca de integração com o Mercado Livre (não é a oficial!)

Build Status Packagist Hex.pm

Obs: essa lib foi construída pela comunidade, se vc deseja utilizar a biblioteca oficial mantida pelo Mercado Livre - clique aqui

Funcionalidades

Requisitos

Dependências

Instalação

Para instalar a biblioteca basta adicioná-la via composer

PHP 5.6+ (versao 1.*)

Ou no composer.json

PHP 7+ (versao 2.*)

Ou no composer.json

Testes

Podemos usar o composer para rodar os testes:

ou utilizando o .phar

Utilização

Para utilizar esta biblioteca, primeiramente você deve ter uma aplicação configurada no Mercado Livre. Caso não esteja habituado com estas funcionalidades, você pode conferir no Getting Started da página do manual do desenvolvedor.

Após a criação da aplicação você terá as informações do App ID (client-id) e Secret Key (client-secret) disponibilizados pelo Mercado Livre. Estas informações serão utilizadas quando você acessar algum recurso que necessita de autorização.

Atualmente o Mercado Livre não possui um ambiente de Sandbox para realização de testes. Todas as publicações serão executadas na sua conta real, conforme descrito no manual.

Você também pode criar um usuário de teste se achar necessário. Com o usuário de teste criado, é possível configurar outra aplicação e ter a App ID (client-id) e Secret Key (client-secret) para o usuário de teste. Lembrando novamente que mesmo com o usuário de teste, os dados aparecerão no ambiente de produção do Mercado Livre.

Exemplo de autenticação e autorização

No manual do desenvolvedor você encontra mais detalhes sobre o fluxo de como funciona a autenticação e autorização do Mercado Livre.

A seguir um pequeno exemplo de como é feita a autenticação usando OAuth com esta biblioteca.

Caso queira enviar o parâmetro state, é possível fazê-lo, como no exemplo:

Exemplo de autenticação Server Side

Outra forma de conseguir o AccessToken é realizando a consulta via client_credentials. Esta forma, é recomendada para scripts que rodam em rotinas automáticas (via cron, ou tarefas agendadas). OBS: para conseguir utilizar, você precisa ter configurado em sua APP, o Scope offline access marcado.

Importante: a lib irá armazenar o access_token e o refresh_token para utilizar nas requisiçōes que necessitarão de autenticação. Ou seja, quando o access_token estiver expirado, ele será atualizado automaticamente pela lib, utilizando o refresh_token.

Com o usuário autenticado já podemos publicar nosso primeiro anúncio.

Publicando um anúncio

Com aplicação configurada e o usuário autenticado, será possível realizar a publicação de um anúncio no Mercado Livre, portanto, você precisa ter as informações da sua App ID e Secret Key criada na aplicação.

Publicando um anúncio com Variações

Mais detalhes em: Manual de Variações

Publicando um anúncio com Atributos

Mais detalhes em: Manual de Atributos

Alterando um anúncio

Para alterar o seu anúncio...

Isso irá variar se o produto já tiver vendas ou não. Além disso, lembre-se de que para poder alterar um produto, ele deve estar ativo. Você pode alterar valores para:

Segue link do manual

Adição ou substituição de uma descrição existente

A descrição de um produto contém informações personalizadas sobre o produto que você está vendendo. Você escolhe a quantidade de informações que vai adicionar à descrição do produto e como elas serão exibidas. Você pode escolher entre uma descrição simples ou um texto sem formatação. As informações exibidas na descrição devem ser um complemento dos atributos do produto que já estamos exibindo na página de descrição do produto. Por exemplo, você pode adicionar especificações, imagens, detalhes da venda, anúncios promocionais e tudo que achar útil e atrativo para que os compradores escolham seu produto, reduzindo a necessidade de fazer mais perguntas antes de fazer uma oferta.

Elementos que devem ser evitados:

Caso você não tenha enviado nada na descrição no momento de publicar o produto, você pode usar o seguinte tutorial para adicioná-la depois. Siga o exemplo a seguir:

Alterando o status de um anúncio

Qualquer produto publicado no Mercado Livre pode ter diferentes status; a seguir, analise a descrição de cada um deles:

Se você precisar fazer alterações no status do produto, deverá enviar um desses valores para o campo “status”. Lembre de que o valor diferencia entre letras maiúsculas e minúsculas e deve ser enviado em letras minúsculas. Para pausar um produto ativo, veja o exemplo a seguir:

Removendo um anúncio

Para remover, basta informar o código do produto. Para realizar esta ação o anúncio tem que estar com o status finalizado.

Recursos públicos

O Mercado Livre disponibiliza recursos públicos e privados. Os recursos públicos são aqueles que qualquer pessoa que conheça a URL de um determinado recurso pode acessar, ou seja, não é necessário passar sua App-ID e Secret Key. Por exemplo, ao acessar o recurso “sites”, você verá todos os países nos quais o Mercado Livre atua.

Exemplos de consultas públicas
Recursos privados

Os recursos privados podem ser acessados somente mediante autorização, portanto, para que você acesse estas informações é necessário que o usuário esteja logado (ou tenha passado pelo fluxo de autorização anteriormente) no Mercado Livre.

Alterando o site

Por padrão, esta biblioteca está configurada para aplicações no Brasil, mas se você precisar, esta configuração poderá ser alterada no momento em que informa suas credenciais, seguindo o exemplo:

Neste link você pode verficar a lista de sites disponíveis.

Contribua!

Quer contribuir? clique aqui

Licença

Esta biblioteca segue os termos de uso da Apache-2.0


All versions of mercado-livre with dependencies

PHP Build Version
Package Version
Requires php Version >=5.6
guzzlehttp/guzzle Version >=6.3.3
jms/serializer Version 1.3.1
doctrine/collections Version ^v1.3.0
doctrine/cache Version ^v1.6.0
doctrine/instantiator Version ^1.0.4
doctrine/annotations Version ^v1.4.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package dsc/mercado-livre contains the following files

Loading the files please wait ....