Entrada: erros
Chamadas de verificação do Domain Score que falham: 401, 402 e linhas vazias
Entrada: erros. Dois códigos HTTP carregam significado, um flag indica se a chamada foi concluída e uma propriedade de dados explica a maioria das surpresas.
Sintoma, causa, correção
| Sintoma | Causa provável | Correção |
|---|---|---|
| HTTP 401 | Chave ausente, digitada incorretamente ou revogada | Envie key=sk_... ou o cabeçalho Bearer; copie a chave novamente na página da conta |
| HTTP 402 | O crédito acabou | Recarregue em USDT (TRC-20); as ações gratuitas ainda funcionam |
| ok é falso | A chamada não foi concluída | Leia o status HTTP primeiro, depois o corpo da resposta |
| O domínio parece sem pontuação | Poucos ou nenhum link no índice | Verifique os domínios de referência; DR 0 significa que nenhum foi encontrado |
| Link recente ausente | O índice é atualizado aproximadamente uma vez por mês | Aguarde a próxima atualização; não tente novamente em loop |
| As páginas param após 50.000 linhas | Limite de paginação | Restrinja com uma consulta ou ordenação, depois faça a paginação novamente |
| Chamada em massa rejeitada | Mais de 2.000 domínios | Divida a lista em partes |
Os pagamentos são em USDT na rede TRC-20. O login é apenas via Google. Listas em massa são limitadas a 2.000 domínios, chamadas de listagem com 1.000 linhas e paginação profunda com 50.000 linhas.
Ordem do diagnóstico
Comece pelo código de status. Um 401 diz respeito à identidade e um 402 ao dinheiro. Eles são corrigidos em lugares diferentes.
Depois, leia ok. Toda resposta o contém. Em chamadas autenticadas, _credits mostra o custo e o saldo restante, para que um saldo esgotado seja visível antes do 402 chegar.
Mantenha essa ordem fixa no seu manual. Qualquer um que pule direto para os dados pode gastar uma manhã resolvendo um problema que o código de status teria identificado imediatamente.
Só depois disso é que você deve suspeitar dos dados. Um site recente pode mostrar um DR baixo. A causa raramente é um bug. A razão mais provável é uma captura mensal que antecede seus links. Compare o valor com a entrada da fórmula.
Separar um problema de chave de um problema de saldo
Um 401 e um 402 parecem iguais em um script, porque ambos interrompem o mesmo loop. Eles têm causas diferentes, então separe-os antes de alterar qualquer coisa.
Comece com uma ação gratuita no mesmo domínio. Se ela responder e a chamada paga não responder, o domínio está OK e o problema está na chave ou no saldo.
Quando um 401 segue uma cópia
Uma chave colada com um espaço no final ou cortada no final é uma causa comum de 401. As chaves começam com sk_, então verifique esse prefixo e compare a string inteira com a cópia na página da conta.
Substitua a chave em um único lugar e execute novamente a mesma chamada única. Alterar várias coisas ao mesmo tempo torna o resultado impossível de ler.
Quando um 402 aparece após um recarregamento
Um 402 significa que a ação paga não tem mais crédito. Leia o saldo restante em _credits na próxima resposta autenticada antes de qualquer outra coisa.
Se esse saldo parecer correto, compare-o com o custo da chamada que falhou. Os números mostrarão se a chamada é simplesmente maior que o saldo.
Guarde uma nota do horário em que você fez o recarregamento, para que o log e o saldo possam ser comparados depois.
Uma breve nota do saldo antes e depois de cada recarregamento facilita a leitura do próximo 402.
Trabalhando com um resultado vazio
Confirme se a chamada foi concluída
Leia ok primeiro. Um valor falso significa que a chamada não terminou, então uma lista vazia não diz nada sobre o domínio.
Verifique o nome que você enviou
O valor q deve ser um domínio nu. Um esquema, um caminho ou um espaço solto podem produzir uma resposta vazia que parece real.
Compare com uma ação gratuita
Execute a visão geral no mesmo nome. Se ela retornar dados e a listagem não, a ação de listagem e seus limites são os próximos suspeitos.
Verifique a data de atualização
O índice é atualizado aproximadamente uma vez por mês. Um link adicionado após a última atualização não aparecerá, não importa quantas vezes você chamar o endpoint.
Política mínima de nova tentativa
- Nunca tente novamente um 401 ou 402 automaticamente
- Tente novamente falhas de rede com atrasos crescentes
- Pare quando _credits mostrar um saldo próximo de zero
- Armazene em cache respostas bem-sucedidas por um mês
- Registre a ação e o domínio com cada falha
Questões de borda
Os créditos são deduzidos para uma chamada falha?
Não declaramos uma regra de faturamento para chamadas falhas nesta referência. Observe _credits na próxima resposta autenticada e compare o saldo restante com sua expectativa.
Por que uma ação gratuita funciona após um 402?
Porque domain, overview, stats e suggest não precisam de chave nem de crédito. Apenas ações pagas são bloqueadas quando o saldo está vazio.
De onde vêm os nomes dos campos?
Veja a entrada de campos da API para a forma geral e chame um endpoint ao vivo para linhas específicas da ação.
Por que uma pontuação pode parecer errada sem nenhum erro
Às vezes todos os campos chegam no prazo e o número ainda te surpreende. A resposta está correta para sua captura, então a pergunta real é o que essa captura contém.
Três situações explicam a maioria desses casos.
Um domínio lançado recentemente
Um site lançado recentemente pode mostrar DR 0 porque a captura antecede seus links. Zero aqui significa que nenhum domínio de link foi encontrado, não um julgamento sobre o site.
Aguarde uma atualização posterior antes de ler o valor como um julgamento do site.
Compare a idade do domínio com o ciclo de atualização antes de agir. Um nome novo e um nome antigo que nunca atraiu links parecem iguais na mesma captura.
Um link que chegou este mês
Links adicionados após a última atualização estão ausentes do valor. Uma chamada repetida retorna a mesma resposta até a próxima atualização chegar.
Anote a data do link e a data da captura, para que a lacuna seja fácil de explicar para qualquer pessoa que leia o relatório.
Um link que desapareceu
Um link pode desaparecer quando sua página é excluída ou o site doador fecha. A contagem então cai embora nada tenha mudado do seu lado.
Compare duas capturas com alguns meses de diferença antes de culpar o endpoint.
Conte quantos domínios se movem, não apenas o total. Uma pequena perda espalhada por muitos sites tem uma leitura diferente de uma grande perda de um único site.
Onde cada correção mora
| Correção | Local |
|---|---|
| Chave nova ou copiada | Página da conta |
| Recarregamento em USDT (TRC-20) | Página da conta |
| Divisão e nova tentativa | Seu próprio código de cliente |
| Aguardando uma atualização | Nada a fazer; o índice é atualizado aproximadamente uma vez por mês |
Reproduzindo uma falha para um relatório de bug
Reduza para uma chamada
Remova o loop e mantenha um único comando curl que falha.
Registre a resposta
Anote o status HTTP, o valor de ok e o campo _credits, se presente.
Tente uma ação gratuita no mesmo domínio
Se overview funcionar e a ação paga não, a falha é de chave ou saldo, não do domínio.
Envie os detalhes
Anote o horário, a ação e os primeiros e últimos caracteres da chave, para que a chamada possa ser correspondida à conta. Mantenha a chave completa fora do relatório.
O que registrar com cada chamada falha
| Registrar | Por que ajuda |
|---|---|
| Status HTTP | Separa um 401 de um 402 à primeira vista |
| O valor ok | Mostra se a chamada foi concluída |
| _credits, quando presente | Mostra o saldo no momento da falha |
| Ação e domínio | Permite repetir a mesma chamada de propósito |
| Horário da chamada | Coloca-a em contraste com a atualização mensal |
Por que não nova tentativa automática
Fazer loop em um 402 consome tempo e não gera ganhos. Fazer loop em um 401 pode ativar a detecção de abuso em qualquer provedor, o nosso ou o do Google.
Reserve novas tentativas para erros de rede e dê a cada nova tentativa uma pausa maior que a anterior. Três tentativas é um teto sensato para um trabalho noturno.
Digamos que um trabalho noturno encontre um 402 às duas da manhã. Tentar novamente a cada cinco minutos até o café da manhã produz aproximadamente cem falhas idênticas, e cada uma é uma linha de log que alguém precisa ler depois.
Use um teto fixo para novas tentativas de rede também e registre cada tentativa. Um teto que você pode declarar em uma frase é fácil de defender quando um trabalho para.
Alertas para um trabalho que roda sem supervisão
Um trabalho noturno de verificação do Domain Score deve informar alguém quando parar, e deve dizer o motivo. Os dois códigos precisam de alertas diferentes, então mantenha-os separados na mensagem.
Alerte no primeiro 401
Um 401 geralmente significa um problema de chave, então uma única falha vale uma mensagem. Esperar por cem falhas idênticas apenas atrasa a correção.
Inclua os primeiros e últimos caracteres da chave no alerta, não a chave inteira, para que a mensagem seja segura para compartilhar com um colega.
Um 402 merece sua própria mensagem, já que seu remédio é um recarregamento em vez de uma troca de chave.
Um trabalho silencioso não é necessariamente um trabalho saudável. Conte as execuções que terminaram, não apenas as que falharam, e alerte quando nenhuma das contagens mudar por um ciclo inteiro.
Alerte sobre um saldo em queda
Defina o aviso em um nível que cubra o resto da execução, não em zero. Um saldo quase vazio quando o trabalho começa não deixa margem para novas tentativas.
Leia o nível de _credits em cada resposta autenticada, para que o aviso não precise de uma solicitação extra.
Nosso rastreador e nosso índice de links são atualizados aproximadamente uma vez por mês. Um site lançado recentemente pode mostrar DR 0, e essa é uma leitura correta da captura, já que ela ainda não contém nenhum domínio de link para o site.
