Domínios, DNS e associação dos aplicativos

Cada domínio pertence a um aplicativo e a um usuário. O cadastro mantém separadas a propriedade (ownership), a configuração DNS (dns), o certificado (https), a disponibilidade dos links (links) e a publicação da configuração. Um campo ativo não substitui a verificação dos demais.

Escolher o endereço

O modo platform reserva um prefixo do domínio disponibilizado pelo Agilink. A reserva permanece vinculada ao proprietário e ao aplicativo mesmo após desvincular o endereço, para impedir a apropriação de links antigos. Em homologação o endereço termina em .links.staging.agilink.io.

O modo managed usa um domínio próprio cuja zona poderá ser administrada pelo Agilink. A conexão apresenta a prova de propriedade e os nameservers necessários. Siga os dados devolvidos pelo sistema; a propagação e a ativação podem exigir novas verificações.

O modo external mantém o DNS no provedor do usuário. O sistema informa os registros de conexão e verificação, conforme a modalidade disponível. Esse modo não oferece edição da zona pela API do Agilink. A disponibilidade é controlada pelo ambiente: consulte /domain-options e /domains/{domainId}/capabilities.

Limites da homologação A3b

A homologação usa uma zona preexistente e uma subárvore isolada. A criação de zonas e o provisionamento SaaS de domínios externos estão desabilitados; /domain-options oferece apenas platform para novas conexões. Pedidos de outros modos retornam 403 feature_disabled. O teste de edição DNS usa uma autorização sintética nessa subárvore; isso não comprova a transferência de nameservers de um domínio de cliente. Os fluxos de negócio possuem verificações locais adicionais.

Associar Android e iOS

A configuração nativa informa pacote Android, impressões digitais do certificado, identidade iOS e prefixos de rotas aceitos. Use os valores do aplicativo publicado. Uma impressão digital incorreta pode manter o endereço acessível no navegador sem abrir o aplicativo.

native-config atualiza a parte nativa; web-config configura o aplicativo web e o prefixo de rota; recovery-config configura a recuperação. Cada atualização preserva as outras partes. As três usam a revisão atual do domínio, portanto consulte novamente antes de uma alteração seguinte.

Quando há aplicativo web configurado, a resolução pode selecionar sua página web. Para conferir a personalização da página Android/iOS, use um cenário que resolva para essa página nativa; o teste de uma modalidade não comprova as outras.

Salvar uma configuração inicia a projeção pública. Consulte publication para acompanhar a confirmação e depois teste os arquivos de associação, o link e o aplicativo em um aparelho. O diagnóstico retorna deviceAssociationTested: false e appClipVerified: false: a API não transforma uma gravação de configuração em teste de dispositivo.

Administrar registros DNS

A edição exige modo administrado, propriedade verificada, zona autorizada, permissão da credencial e nome pertencente ao domínio. A lista identifica registros protegidos e suas restrições. A API permite A, AAAA, CNAME, TXT e MX, respeitando as regras do provedor e do produto.

Criar um registro usa o ETag do domínio. Alterar ou excluir usa o ETag do registro, derivado da versão consultada no provedor. Se o registro mudar entre a consulta e a execução, o sistema recusa a versão antiga. A execução acontece por operação assíncrona; um 202 ainda não confirma que o provedor aplicou a mudança.

Verificar e desvincular

Uma verificação explícita consulta a situação atual e pode aguardar propagação. Desvincular exige revisão e ausência de links ou domínio padrão do aplicativo que dependam do endereço. O sistema preserva a reserva e o histórico. Consulte a operação até seu estado final e verifique o domínio novamente.

Veja o guia de integração e os requests e responses dos endpoints.