Indo para produção

Checklist antes de colocar a integração V2 no ar.

1. Ative o Webservice na sua conta

Certifique-se de ter o app_name além do seu usuário e senha antes de continuar, sem ele não será possível gerar o token de autenticação.

2. Aponte para a URL certa

Cada ambiente tem sua própria base — troque apenas o host, mantendo o caminho:

Ao entrar em produção, use a base de produção em todas as chamadas.

3. Autenticação e sessão

• Faça POST /auth/login (com email, password, device_name) e reutilize o token (Authorization: Bearer {token}).
• Trate 401 refazendo o login. Veja Autenticação.
• Nunca versione o token nem o exponha no cliente.

4. Não fixe o catálogo no código

Produtos, variações e preços variam por agência e tabela. Consulte o catálogo pela API a cada operação — veja Produtos e operadoras.

5. Mantenha saldo na carteira

Cada ativação debita o valor do pedido; sem saldo, a criação é recusada com 422. Monitore com GET /current-balance — veja Créditos e saldo.

6. Trate a validação estrita

A V2 valida o payload inteiro na entrada. Envie os tipos corretos (product_id/variation_id numéricos, client e items como objetos/arrays) e trate as respostas 422, lendo errors por campo — veja Erros.

7. Percorra listas com paginação

Endpoints de lista retornam páginas. Use ?page=N até current_page alcançar last_page — veja Paginação.

8. Gere seus clientes a partir da spec

Baixe a collection do Postman ou o OpenAPI na Visão Geral para importar em ferramentas e gerar SDKs.

Próximos passos

• Reveja o Quick Start.
• Explore a Referência da API com o Try It.