Ambientes e lançamento
API · v1 · Produção · Revisado em · Markdown
| Ambiente | API administrativa | Documentação | Área autenticada |
|---|---|---|---|
| Produção | https://api.agilink.io/v1 |
Docs | Desenvolvedores |
| Homologação | https://api.staging.agilink.io/v1 |
Docs de testes | Desenvolvedores de testes |
Entre em produção com sua conta autorizada do Agilink. Em homologação, solicite uma conta de teste; contas e dados são separados. O portal não cria contas de provedor nem exige credenciais administrativas. A sessão humana é mantida em memória; sair ou fechar a página remove a sessão local.
Emita uma chave por integração com prazo, apps e permissões mínimos. agl_live_ pertence a produção; agl_test_, a homologação. O segredo aparece somente na emissão e deve ser guardado no servidor. Chaves não são autorização delegada OAuth; agentes de terceiros terão esse fluxo em entrega posterior.
O console começa em sandbox. A seleção de ambiente navega para o portal correspondente e encerra a conexão atual. Cada mutação real exige revisão e confirmação. Exemplos de cURL, Postman, JavaScript e Python usam homologação por padrão. No cliente de receita, selecione produção explicitamente; use também uma credencial de produção, sem transferir a de homologação.
Migração por consumidor
Seção intitulada “Migração por consumidor”- Compare leituras em homologação e valide o fluxo completo com dados sintéticos.
- Adapte envelopes, paginação, ETag e chave de idempotência; preserve uma única intenção por escrita.
- Emita uma chave produtiva restrita e habilite um consumidor por vez.
- Acompanhe requestId, 401/403, 409/412, 429, operações e publicação. Após timeout, consulte ou repita a mesma intenção.
- Revogue o token antigo somente após validar o consumidor. Antes de revogar, é possível retornar ao cliente anterior; depois, uma nova credencial exige autorização.
O portal de desenvolvedores e a área de organização são os primeiros consumidores internos migrados. O dashboard principal, SDK, IDs de links e tokens existentes conservam compatibilidade. Não há data automática de desligamento do legado.
Disponibilidade e limites
Seção intitulada “Disponibilidade e limites”As 143 operações têm implementação e contrato. Modalidades de domínio exigem provedores habilitados, prova de propriedade, DNS e TLS; uma resposta 202 não confirma propagação. O staging usa somente seu subdomínio de testes, sem habilitar domínios externos reais nesse ambiente. Exports e lotes exigem consulta de estado. Os limites técnicos não representam franquias comerciais.
A verificação do lançamento incluiu uma jornada sintética em produção e ensaios curtos de concorrência em homologação. Não estabelece SLA global, capacidade sustentada, leitura física de QR ou atribuição garantida após instalação. OAuth e MCP serão executados nas próximas tarefas, nessa ordem.