Download the PHP package miqueiasdesouza/tagplus without Composer
On this page you can find all versions of the php package miqueiasdesouza/tagplus. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download miqueiasdesouza/tagplus
More information about miqueiasdesouza/tagplus
Files in miqueiasdesouza/tagplus
Package tagplus
Short Description Um cliente PHP para consumir a API do ERP TagPlus.
License
Informations about the package tagplus
SDK PHP TagPlus
A SDK facilita a integração com a nossa API do ERP, principalmente nas etapas de autenticação. Código Original: TagPlus/sdk-api-php
Requisitos
- PHP >= 5.4
- Composer
Preparando
Vamos instalar a SDK via Composer:
Como usar
IMPORTANTE: Para prosseguir você já precisa ter se registrado no portal da API e ter disponível seu client_id
, client_secret
e redirect_uri
. Caso ainda não tenha se registrado acesse aqui e clique em Cadastrar.
A API utiliza o OAuth2 para autenticação, vamos mostrar um exemplo de como você deve utilizar a SDK para efetuar a autenticação. Confira nossa documentação de API aqui.
1. Autorização do usuário
O primeiro passo é redirecionar o usuário para o TagPlus, para que assim ele possa autorizar sua aplicação. Normalmente é um link em determinado pedaço da sua página web.
Ao clicar no link o usuário poderá autorizar (ou não) a sua aplicação a acessar os recursos solicitados (scope).
2. Receber o código e recuperar token
Como término do passo anterior o usuário será redirecionado para a url cadastrada no portal (redirect_uri
).
Nesse página de retorno (callback) você deve ter os seguintes trechos de código:
O trecho de código acima vai recuperar um access token válido e salvá-lo no arquivo cujo nome foi passado ao criar a classe FileTokenPersistence.
3. Acessando API
Agora já está tudo pronto para utilizar a API:
Esse foi apenas um exemplo de como usar a API do ERP TagPlus. Para mais detalhes de quais recursos estão disponíveis acesse nossa referência.
Próximos passos
[ ] Explicar como armazenar os tokens no BD (ex.: MySQL);
[ ] Explicar como usar a SDK junto com uma framework (ex.: Laravel, CodeIgniter, Symfony, etc...);
[ ] Recuperar todas as páginas (quando houver) automaticamente;
[ ] Já retornar a instância do Objeto, sem precisar chamar a função json_decode;
[ ] Ter métodos para todos os recursos, ao invés de passar a URL como parâmetro (ex.: $api->getClientes()
).
All versions of tagplus with dependencies
guzzlehttp/guzzle Version ^5
kamermans/guzzle-oauth2-subscriber Version ^1