Eintrag: Fehler
Domain-Score-Abfragen, die fehlschlagen: 401, 402 und leere Zeilen
Eintrag: Fehler. Zwei HTTP-Codes haben eine Bedeutung, ein Flag zeigt an, ob eine Abfrage abgeschlossen wurde, und eine Dateneigenschaft erklärt die meisten Überraschungen.
Symptom, Ursache, Lösung
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| HTTP 401 | Schlüssel fehlt, falsch eingegeben oder widerrufen | Senden Sie key=sk_... oder den Bearer-Header; kopieren Sie den Schlüssel erneut von der Kontoseite |
| HTTP 402 | Guthaben aufgebraucht | Aufladen mit USDT (TRC-20); kostenlose Aktionen funktionieren weiterhin |
| ok ist falsch | Die Abfrage wurde nicht abgeschlossen | Lesen Sie zuerst den HTTP-Status, dann den Antworttext |
| Domain wurde noch nicht bewertet | Wenige oder keine Links im Index | Schauen Sie sich die verweisenden Domains an; ein DR von 0 bedeutet, dass keine gefunden wurden |
| Neuer Link fehlt | Index-Aktualisierungen erfolgen etwa monatlich | Warten Sie auf die nächste Aktualisierung; wiederholen Sie nicht in einer Schleife |
| Seiten stoppen nach 50.000 Zeilen | Paginierungsgrenze | Verengen Sie mit einer Abfrage oder Sortierung, und paginieren Sie dann erneut |
| Massenabfrage abgelehnt | Mehr als 2.000 Domains | Teilen Sie die Liste in Chunks auf |
Zahlungen erfolgen in USDT im TRC-20-Netzwerk. Die Anmeldung erfolgt nur über Google. Massenlisten sind auf 2.000 Domains begrenzt, Listenaufrufe auf 1.000 Zeilen und tiefes Paging auf 50.000 Zeilen.
Reihenfolge der Diagnose
Beginnen Sie mit dem Statuscode. Ein 401 betrifft die Identität, ein 402 das Geld. Sie werden an unterschiedlichen Stellen behoben.
Lesen Sie dann ok. Jede Antwort enthält diesen Wert. Bei authentifizierten Aufrufen zeigt _credits die Kosten und den verbleibenden Saldo an, sodass ein erschöpftes Guthaben sichtbar wird, bevor das 402 eintrifft.
Halten Sie diese Reihenfolge in Ihrem Runbook fest. Jeder, der direkt zu den Daten springt, kann einen ganzen Morgen mit einem Problem verbringen, das der Statuscode sofort benannt hätte.
Erst danach sollten Sie die Daten in Verdacht ziehen. Eine junge Website zeigt oft einen niedrigen DR. Die Ursache ist selten ein Fehler. Der wahrscheinlichere Grund ist ein monatlicher Snapshot, der älter ist als ihre Links. Vergleichen Sie die Zahl mit dem Formel-Eintrag.
Trennung eines Schlüsselproblems von einem Guthabenproblem
Ein 401 und ein 402 sehen in einem Skript gleich aus, da beide die gleiche Schleife stoppen. Sie haben unterschiedliche Ursachen, also trennen Sie sie, bevor Sie etwas ändern.
Beginnen Sie mit einer kostenlosen Aktion auf derselben Domain. Wenn sie antwortet und die bezahlte Aktion nicht, ist die Domain in Ordnung und das Problem liegt beim Schlüssel oder Guthaben.
Wenn ein 401 auf ein Kopieren folgt
Ein Schlüssel, der mit einem Leerzeichen am Ende oder einem abgeschnittenen Ende kopiert wurde, ist eine häufige Ursache für ein 401. Schlüssel beginnen mit sk_, also prüfen Sie dieses Präfix und vergleichen Sie die gesamte Zeichenfolge mit dem Kopierinhalt auf der Kontoseite.
Ersetzen Sie den Schlüssel an einer Stelle und führen Sie denselben einzelnen Aufruf erneut aus. Das Ändern mehrerer Dinge gleichzeitig macht das Ergebnis unlesbar.
Wenn ein 402 nach einem Aufladen erscheint
Ein 402 bedeutet, dass für die bezahlte Aktion kein Guthaben mehr vorhanden ist. Lesen Sie den verbleibenden Saldo in _credits bei der nächsten authentifizierten Antwort, bevor Sie etwas anderes tun.
Wenn dieser Saldo korrekt aussieht, vergleichen Sie ihn mit den Kosten des fehlgeschlagenen Aufrufs. Die Zahlen zeigen, ob der Aufruf einfach größer ist als das Guthaben.
Notieren Sie sich die Zeit des Aufladens, damit das Protokoll und das Guthaben später verglichen werden können.
Eine kurze Notiz des Guthabens vor und nach jedem Aufladen macht das nächste 402 leichter lesbar.
Durcharbeitung eines leeren Ergebnisses
Bestätigen Sie, dass die Abfrage abgeschlossen wurde
Lesen Sie zuerst ok. Ein falscher Wert bedeutet, dass die Abfrage nicht abgeschlossen wurde, also sagt eine leere Liste nichts über die Domain aus.
Prüfen Sie den gesendeten Namen
Der q-Wert muss eine nackte Domain sein. Ein Schema, ein Pfad oder ein fehlgeschlagenes Leerzeichen kann eine leere Antwort erzeugen, die wie eine echte aussieht.
Vergleich mit einer kostenlosen Aktion
Führen Sie eine Übersicht für denselben Namen aus. Wenn sie Daten zurückgibt und die Liste nicht, ist die Listenaktion und ihre Grenzen der nächste Verdächtige.
Prüfen Sie das Aktualisierungsdatum
Der Index wird etwa einmal im Monat aktualisiert. Ein nach der letzten Aktualisierung hinzugefügter Link erscheint nicht, egal wie oft Sie den Endpunkt aufrufen.
Minimale Wiederholungsrichtlinie
- Wiederholen Sie ein 401 oder 402 nicht automatisch
- Wiederholen Sie Netzwerkfehler mit wachsenden Verzögerungen
- Stoppen Sie, wenn _credits ein Guthaben nahe Null anzeigt
- Speichern Sie erfolgreiche Antworten für den Monat
- Protokollieren Sie die Aktion und die Domain bei jedem Fehler
Randfragen
Werden Guthaben für einen fehlgeschlagenen Aufrub abgezogen?
Wir geben keine Abrechnungsregel für fehlgeschlagene Aufrufe in dieser Referenz an. Beobachten Sie _credits bei der nächsten authentifizierten Antwort und vergleichen Sie das verbleibende Guthaben mit Ihrer Erwartung.
Warum funktioniert eine kostenlose Aktion nach einem 402?
Weil domain, overview, stats und suggest keinen Schlüssel und kein Guthaben benötigen. Nur bezahlte Aktionen werden blockiert, sobald das Guthaben leer ist.
Woher stammen die Feldnamen?
Siehe den API-Feldeintrag für die allgemeine Struktur und rufen Sie einen Live-Endpunkt für actionspezifische Zeilen auf.
Warum eine Bewertung falsch aussehen kann, ohne Fehler
Manchmal kommen alle Felder pünktlich an und die Zahl überrascht Sie trotzdem. Die Antwort ist für ihren Snapshot korrekt, also ist die eigentliche Frage, was dieser Snapshot enthält.
Drei Situationen erklären die meisten dieser Fälle.
Eine kürzlich gestartete Domain
Eine kürzlich gestartete Website kann DR 0 anzeigen, weil der Snapshot älter ist als ihre Links. Null bedeutet hier, dass keine verweisende Domain gefunden wurde, kein Urteil über die Website.
Warten Sie auf eine spätere Aktualisierung, bevor Sie die Zahl als Urteil über die Website lesen.
Vergleichen Sie das Alter der Domain mit dem Aktualisierungszyklus, bevor Sie handeln. Ein neuer Name und ein alter Name, der nie Links angezogen hat, sehen im selben Snapshot gleich aus.
Ein Link, der diesen Monat ankam
Nach der neuesten Aktualisierung hinzugefügte Links fehlen in der Zahl. Ein wiederholter Aufruf gibt dieselbe Antwort zurück, bis die nächste Aktualisierung eintrifft.
Notieren Sie das Datum des Links und das Datum des Snapshots, damit die Lücke für jeden, der den Bericht liest, leicht erklärt werden kann.
Ein Link, der verschwunden ist
Ein Link kann verschwinden, wenn seine Seite gelöscht wird oder die Geberdomain schließt. Die Anzahl fällt dann, obwohl sich auf Ihrer Seite nichts geändert hat.
Vergleichen Sie zwei Snapshots mit einigen Monaten Abstand, bevor Sie dem Endpunkt die Schuld geben.
Zählen Sie, wie viele Domains sich bewegen, nicht nur die Gesamtzahl. Ein kleiner Verlust, der sich auf viele Websites verteilt, liest sich anders als ein großer Verlust von einer einzelnen Website.
Wo jede Lösung zu finden ist
| Lösung | Ort |
|---|---|
| Neuer oder kopierter Schlüssel | Kontoseite |
| Aufladen mit USDT (TRC-20) | Kontoseite |
| Chunking und Wiederholung | Ihr eigener Client-Code |
| Warten auf eine Aktualisierung | Nichts zu tun; der Index wird etwa monatlich aktualisiert |
Wiedergeben eines Fehlers für einen Fehlerbericht
Auf einen Aufruf reduzieren
Entfernen Sie die Schleife und behalten Sie einen einzelnen curl-Befehl, der fehlschlägt.
Antwort aufzeichnen
Notieren Sie den HTTP-Status, den Wert von ok und das Feld _credits, falls vorhanden.
Testen Sie eine kostenlose Aktion auf derselben Domain
Wenn overview funktioniert und die bezahlte Aktion nicht, liegt der Fehler beim Schlüssel oder Guthaben, nicht an der Domain.
Details senden
Notieren Sie sich die Zeit, die Aktion und die ersten und letzten Zeichen des Schlüssels, damit der Aufruf dem Konto zugeordnet werden kann. Halten Sie den vollständigen Schlüssel aus dem Bericht heraus.
Was bei jedem fehlgeschlagenen Aufruf aufgezeichnet werden soll
| Aufzeichnen | Warum es hilft |
|---|---|
| HTTP-Status | Trennt ein 401 von einem 402 auf einen Blick |
| Der ok-Wert | Zeigt an, ob die Abfrage abgeschlossen wurde |
| _credits, wenn vorhanden | Zeigt das Guthaben zum Zeitpunkt des Fehlers an |
| Aktion und Domain | Ermöglicht es, denselben Aufruf absichtlich zu wiederholen |
| Zeitpunkt des Aufrufs | Platziert ihn gegenüber der monatlichen Aktualisierung |
Warum nicht automatisch wiederholen
Schleifen bei einem 402 verbrauchen Zeit und bringen nichts. Schleifen bei einem 401 können bei jedem Anbieter, unserem oder Google, die Missbrauchserkennung auslösen.
Behalten Sie Wiederholungen für Netzwerkfehler vor, und geben Sie jeder Wiederholung eine längere Pause als die letzte. Drei Versuche sind eine sinnvolle Obergrenze für einen nächtlichen Job.
Sagen wir, ein nächtlicher Job trifft um zwei Uhr morgens auf ein 402. Das Wiederholen alle fünf Minuten bis zum Frühstück erzeugt etwa hundert identische Fehler, und jeder ist eine Protokollzeile, die jemand später lesen muss.
Verwenden Sie auch für Netzwerk-Wiederholungen eine feste Obergrenze, und protokollieren Sie jeden Versuch. Eine Obergrenze, die Sie in einem Satz angeben können, ist leicht zu verteidigen, wenn ein Job stoppt.
Warnungen für einen unbeaufsichtigten Job
Ein nächtlicher Domain-Score-Check-Job sollte jemandem mitteilen, wenn er stoppt, und warum. Die beiden Codes benötigen unterschiedliche Warnungen, also halten Sie sie in der Nachricht getrennt.
Warnen bei der ersten 401
Ein 401 bedeutet normalerweise ein Schlüsselproblem, also ist ein einzelner Fehler eine Nachricht wert. Auf hundert identische Fehler zu warten, verzögert die Lösung nur.
Nehmen Sie die ersten und letzten Zeichen des Schlüssels in die Warnung auf, nicht den gesamten Schlüssel, damit die Nachricht sicher mit einem Kollegen geteilt werden kann.
Ein 402 verdient eine eigene Nachricht, da seine Lösung ein Aufladen ist und keine Schlüsseländerung.
Ein ruhiger Job ist nicht unbedingt ein gesunder Job. Zählen Sie die abgeschlossenen Durchläufe, nicht nur die fehlgeschlagenen, und warnen Sie, wenn keine der beiden Zahlen für einen vollständigen Zyklus bewegt wird.
Warnen bei fallendem Guthaben
Legen Sie die Warnung auf einem Niveau fest, das den Rest des Laufs abdeckt, nicht bei Null. Ein Guthaben, das bei Start des Jobs fast leer ist, lässt keinen Raum für Wiederholungen.
Lesen Sie das Niveau bei jeder authentifizierten Antwort aus _credits, damit die Warnung keine zusätzliche Anfrage benötigt.
Unser Crawler und unser Link-Index werden etwa einmal im Monat aktualisiert. Eine kürzlich gestartete Website kann DR 0 anzeigen, und das ist eine korrekte Lesung des Snapshots, da er noch keine verweisende Domain für die Website enthält.
