---
title: Ambientes e lançamento
description: Bases publicadas, acesso e migração gradual da API v1.
---

| Ambiente | API administrativa | Documentação | Área autenticada |
| --- | --- | --- | --- |
| Produção | `https://api.agilink.io/v1` | [Docs](https://docs.agilink.io/) | [Desenvolvedores](https://developers.agilink.io/developers) |
| Homologação | `https://api.staging.agilink.io/v1` | [Docs de testes](https://docs.staging.agilink.io/) | [Desenvolvedores de testes](https://dashboard.staging.agilink.io/developers) |

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

1. Compare leituras em homologação e valide o fluxo completo com dados sintéticos.
2. Adapte envelopes, paginação, ETag e chave de idempotência; preserve uma única intenção por escrita.
3. Emita uma chave produtiva restrita e habilite um consumidor por vez.
4. Acompanhe requestId, 401/403, 409/412, 429, operações e publicação. Após timeout, consulte ou repita a mesma intenção.
5. 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

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.