Ry.hk Ry.hk

Carrinho de compras

Noções básicas do API: chaves, chamadas e tratamento de falhas

Última atualização 27/10/2026

API e desenvolvedores Última atualização 27/10/2026
O API expõe as mesmas operações que a área cliente faz, sobre HTTPS com respostas JSON. Qualquer coisa que você possa fazer em um domínio no navegador, você pode criar scripts. Obtenha uma chave primeiro Crie uma chave API na área do cliente. Use uma chave separada por sistema para que a revogação de uma não prejudique as outras e mantenha-a em um servidor: uma chave no código do navegador ou em um pacote móvel é uma chave que você publicou. Armazene-o em uma variável de ambiente ou em um gerenciador de segredos, nunca em um repositório. O que você pode fazer Domínios: verifique a disponibilidade, registre, renove e leia o status e as datas de validade. DNS: lê e define servidores de nomes e mantém registros DNS. Privacidade e contatos: defina o nível de privacidade e atualize os registros de registrante, administrador, tecnologia e faturamento. Pedidos e faturamento: leia pedidos, faturas e status de pagamento. Conta: leia o saldo e os detalhes básicos da conta. Projete para o fracasso antes que você precise dele Limites de taxa, tempos limite de rede e atrasos de upstream acontecem. Tente novamente leituras idempotentes livremente. Para qualquer coisa que faça um pedido, envie uma referência de solicitação exclusiva e verifique-a antes de escrever novamente - caso contrário, uma nova chamada poderá registrar o mesmo domínio duas vezes. Registre a referência, o domínio e o código de resposta para cada chamada. Quando algo é contestado posteriormente, esses registros são a única prova de que uma ação foi tomada. Compensações para pensar O registro e a renovação são pedidos reais e custam dinheiro real: mantenha um saldo ou um método de pagamento funcional e teste o fluxo em um pequeno número de domínios antes de apontar um sistema automatizado para um lote grande. Quando algo parece errado Leia o corpo da resposta - ele contém o motivo, não apenas um código de status. Em seguida, verifique se a chave ainda está ativa e se o domínio está em um estado que permite a operação. Caso a resposta ainda não esteja clara, abra um ticket com a referência da solicitação e o horário da chamada.

Este artigo foi útil?

Envie o domínio, número do pedido ou uma captura de tela com sua mensagem e ela será resolvida em menos rodadas. As alterações sensíveis à conta passam por um ticket.