Indo para produção

Antes de colocar sua integração no ar, percorra este checklist. Ele reúne as decisões que evitam surpresas quando o tráfego real começ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 e reutilize o token nas chamadas seguintes (Authorization: Bearer {token}).
• Trate 401 Unauthorized refazendo o login — token ausente, expirado ou inválido. Veja Autenticação.
• Nunca versione o token nem o exponha no cliente. Ele vale como uma senha.

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

Produtos, itens e preços variam por agência e por tabela de preço. Consulte o catálogo pela API a cada operação em vez de fixar IDs e valores. Veja Produtos e operadoras.

5. Mantenha saldo na carteira

Cada ativação debita o valor do pedido automaticamente. Monitore o saldo com GET /current-balance e recarregue quando necessário — veja Créditos e saldo.

6. Respeite as regras de ativação

• dateActive não pode ser uma data no passado.
• Depois de Concluído ou Cancelado, o pedido é imutável.

Próximos passos

• Reveja o Quick Start para o fluxo mínimo de ponta a ponta.
• Explore a Referência da API com o Try It interativo.