Entry: errori
Chiamate di verifica del Domain Score che falliscono: 401, 402 e righe vuote
Entry: errori. Due codici HTTP hanno un significato, un flag indica se una chiamata è stata completata e una proprietà dei dati spiega la maggior parte delle sorprese.
Sintomo, causa, correzione
| Sintomo | Presunta causa | Correzione |
|---|---|---|
| HTTP 401 | Chiave mancante, digitata male o revocata | Invia key=sk_... o l'header Bearer; copia di nuovo la chiave dalla pagina dell'account |
| HTTP 402 | I crediti sono esauriti | Ricarica in USDT (TRC-20); le azioni gratuite continuano a funzionare |
| ok è false | La chiamata non è stata completata | Leggi prima lo stato HTTP, poi il corpo della risposta |
| Il dominio appare senza punteggio | Pochi o nessun link nell'indice | Controlla i domini di riferimento; un DR di 0 significa che non ne sono stati trovati |
| Link recente mancante | L'indice viene aggiornato approssimativamente una volta al mese | Attendi il prossimo aggiornamento; non riprovare in un loop |
| Le pagine si fermano a 50.000 righe | Limite di paginazione | Riduci con una query o un ordinamento, poi ripagina |
| Chiamata bulk rifiutata | Più di 2.000 domini | Dividi la lista in blocchi |
I pagamenti sono in USDT sulla rete TRC-20. L'accesso è solo tramite Google. Le liste bulk sono limitate a 2.000 domini, le chiamate di elenco a 1.000 righe e la paginazione profonda a 50.000 righe.
Ordine della diagnosi
Inizia con il codice di stato. Un 401 riguarda l'identità e un 402 riguarda il denaro. Vengono risolti in punti diversi.
Poi leggi ok. Ogni risposta lo contiene. Nelle chiamate autenticate, _credits mostra il costo e il saldo residuo, quindi un saldo esaurito è visibile prima che arrivi il 402.
Mantieni questo ordine fisso nel tuo runbook. Chi salta direttamente ai dati può perdere una mattina a risolvere un problema che il codice di stato avrebbe identificato immediatamente.
Solo dopo dovresti sospettare dei dati. Un sito giovane spesso mostra un DR basso. La causa è raramente un bug. La ragione più probabile è un snapshot mensile precedente ai suoi link. Confronta il valore con la vostra formula.
Separare un problema della chiave da un problema del saldo
Un 401 e un 402 sembrano simili in uno script, perché fermano lo stesso loop. Hanno cause diverse, quindi separali prima di modificare qualcosa.
Inizia con un'azione gratuita sullo stesso dominio. Se risponde e la chiamata a pagamento non lo fa, il dominio è a posto e il problema risiede nella chiave o nel saldo.
Quando un 401 segue una copia
Una chiave incollata con uno spazio finale o tronca è una causa comune di un 401. Le chiavi iniziano con sk_, quindi controlla quel prefisso e confronta l'intera stringa con quella nella pagina dell'account.
Sostituisci la chiave in un unico punto e ripeti la stessa chiamata singola. Modificare più cose contemporaneamente rende il risultato impossibile da leggere.
Quando appare un 402 dopo una ricarica
Un 402 significa che l'azione a pagamento non ha più crediti. Leggi il saldo residuo in _credits nella prossima risposta autenticata prima di qualsiasi altra cosa.
Se quel saldo sembra corretto, confrontalo con il costo della chiamata fallita. I numeri mostreranno se la chiamata è semplicemente più grande del saldo.
Prendi nota dell'orario della ricarica, in modo che il log e il saldo possano essere confrontati in seguito.
Una breve nota sul saldo prima e dopo ogni ricarica rende la lettura del prossimo 402 più semplice.
Analisi di un risultato vuoto
Conferma che la chiamata sia stata completata
Leggi prima ok. Un valore false significa che la chiamata non è terminata, quindi un elenco vuoto non ti dice nulla sul dominio.
Controlla il nome inviato
Il valore q deve essere un dominio nudo. Uno schema, un percorso o uno spazio estraneo possono produrre una risposta vuota che sembra reale.
Confronta con un'azione gratuita
Esegui overview sullo stesso nome. Se restituisce dati e l'elenco no, l'azione di elenco e i suoi limiti sono i prossimi sospettati.
Controlla la data di aggiornamento
L'indice viene aggiornato approssimativamente una volta al mese. Un link aggiunto dopo l'ultimo aggiornamento non apparirà, non importa quante volte chiami l'endpoint.
Politica di retry minima
- Non riprovare mai automaticamente un 401 o un 402
- Riprova i guasti di rete con ritardi crescenti
- Fermati quando _credits mostra un saldo vicino allo zero
- Memorizza nella cache le risposte positive per il mese
- Registra l'azione e il dominio con ogni fallimento
Domande marginali
I crediti vengono detratti per una chiamata fallita?
Non dichiariamo una regola di fatturazione per le chiamate fallite in questo riferimento. Osserva _credits nella prossima risposta autenticata e confronta il saldo residuo con le tue aspettative.
Perché un'azione gratuita funziona dopo un 402?
Perché domain, overview, stats e suggest non richiedono chiave né crediti. Solo le azioni a pagamento vengono bloccate una volta che il saldo è vuoto.
Da dove provengono i nomi dei campi?
Vedi la vostra voce API per la forma generale e chiama un endpoint live per le righe specifiche all'azione.
Perché un punteggio può sembrare errato senza errori
A volte tutti i campi arrivano in tempo e il numero ti sorprende comunque. La risposta è corretta per il suo snapshot, quindi la vera domanda è cosa contenga quello snapshot.
Tre situazioni spiegano la maggior parte di questi casi.
Un dominio lanciato di recente
Un sito lanciato di recente può mostrare DR 0 perché lo snapshot è precedente ai suoi link. Zero qui significa che non è stato trovato alcun dominio di riferimento, non un giudizio sul sito.
Attendi un aggiornamento successivo prima di leggere il valore come un giudizio sul sito.
Confronta l'età del dominio con il ciclo di aggiornamento prima di agire. Un nome nuovo e un nome vecchio che non ha mai attirato link appaiono uguali nello stesso snapshot.
Un link arrivato questo mese
I link aggiunti dopo l'ultimo aggiornamento mancano nel valore. Una chiamata ripetuta restituisce la stessa risposta fino all'arrivo del prossimo aggiornamento.
Prendi nota della data del link e della data dello snapshot, in modo che il divario sia facile da spiegare a chiunque legga il report.
Un link scomparso
Un link può scomparire quando la sua pagina viene eliminata o il sito donatore chiude. Il conteggio diminuisce anche se non è cambiato nulla dalla tua parte.
Confronta due snapshot a distanza di alcuni mesi prima di dare la colpa all'endpoint.
Conta quanti domini si muovono, non solo il totale. Una piccola perdita diffusa su molti siti si legge in modo diverso da una grande perdita da un singolo sito.
Dove risiede ogni correzione
| Correzione | Luogo |
|---|---|
| Chiave nuova o copiata | Pagina dell'account |
| Ricarica in USDT (TRC-20) | Pagina dell'account |
| Chunking e retry | Il tuo codice client |
| Attesa per un aggiornamento | Niente da fare; l'indice viene aggiornato approssimativamente una volta al mese |
Riproduzione di un fallimento per un bug report
Riduci a una chiamata
Rimuovi il loop e mantieni un singolo comando curl che fallisce.
Registra la risposta
Annota lo stato HTTP, il valore di ok e il campo _credits se presente.
Prova un'azione gratuita sullo stesso dominio
Se overview funziona e l'azione a pagamento no, il problema è la chiave o il saldo, non il dominio.
Invia i dettagli
Annota l'ora, l'azione e i primi e ultimi caratteri della chiave, in modo che la chiamata possa essere abbinata all'account. Tieni la chiave completa fuori dal report.
Cosa registrare con ogni chiamata fallita
| Registra | Perché aiuta |
|---|---|
| Stato HTTP | Separa un 401 da un 402 a colpo d'occhio |
| Il valore ok | Mostra se la chiamata è stata completata |
| _credits, quando presente | Mostra il saldo al momento del fallimento |
| Azione e dominio | Ti permette di ripetere la stessa chiamata appositamente |
| Ora della chiamata | La colloca rispetto all'aggiornamento mensile |
Perché non il retry automatico
Fare loop su un 402 consuma tempo e non porta a nulla. Fare loop su un 401 può attivare il rilevamento degli abusi su qualsiasi provider, nostro o di Google.
Riserva i retry per gli errori di rete e concedi a ogni retry una pausa più lunga del precedente. Tre tentativi sono un limite ragionevole per un lavoro notturno.
Immagina che un lavoro notturno incontri un 402 alle due del mattino. Riprovare ogni cinque minuti fino a colazione produce circa cento fallimenti identici, e ognuno è una riga di log che qualcuno dovrà leggere in seguito.
Usa un limite fisso anche per i retry di rete e registra ogni tentativo. Un limite che puoi esprimere in una frase è facile da difendere quando un lavoro si interrompe.
Avvisi per un lavoro eseguito in modalità non presidiata
Un lavoro notturno di verifica del Domain Score dovrebbe avvisare qualcuno quando si interrompe e dovrebbe dire il perché. I due codici richiedono avvisi diversi, quindi mantienili separati nel messaggio.
Avvisa al primo 401
Un 401 di solito significa un problema con la chiave, quindi un singolo fallimento vale un messaggio. Aspettare cento fallimenti identici ritarda solo la correzione.
Includi i primi e ultimi caratteri della chiave nell'avviso, non l'intera chiave, in modo che il messaggio sia sicuro da condividere con un collega.
Un 402 merita un messaggio separato, poiché la sua soluzione è una ricarica piuttosto che un cambio di chiave.
Un lavoro silenzioso non è necessariamente sano. Conta le esecuzioni completate, non solo quelle fallite, e avvisa quando nessuno dei due conteggi si muove per un ciclo completo.
Avvisa per un saldo in calo
Imposta l'avviso a un livello che copra il resto dell'esecuzione, non a zero. Un saldo quasi vuoto all'avvio del lavoro non lascia spazio per i retry.
Leggi il livello da _credits su ogni risposta autenticata, in modo che l'avviso non richieda una richiesta extra.
Il nostro crawler e il nostro indice dei link vengono aggiornati approssimativamente una volta al mese. Un sito lanciato di recente può mostrare DR 0, ed è una lettura corretta dello snapshot, poiché non contiene ancora alcun dominio di riferimento per il sito.
