Microsoft Web IQ-Fehlerbehandlung

Alle v3-APIs geben standardisierte Fehlerantworten zurück, um Probleme schnell zu diagnostizieren und zu beheben. In diesem Abschnitt werden HTTP-Statuscodes, Fehlerantwortstruktur und allgemeine Problembehandlungsszenarien behandelt.

Die v1-Kundenverwaltungs-API verwendet separate Status von autorisierten Ressourcen und Bereichsverwaltungsstatuscodes und Fehlerstellen.

Note

Bei allen Zeichenfolgenumwerten wird die Groß-/Kleinschreibung beachtet.

HTTP-Statuscodes

Statuscode Gilt für Fehlerkategorie Description Häufige Ursachen
200 Alle APIs Success Die Anfrage war erfolgreich. -
202 Nur durchsuchen Akzeptiert Anforderung für die Verarbeitung akzeptiert (Live-Durchforstung). On-Demand-Durchforstung in Bearbeitung, wenn liveCrawl "Fallback" ist
400 Alle APIs Ungültige Anforderung Ungültige Anforderungsparameter. Fehlende erforderliche Felder, ungültige Parameterwerte, falsch formatierter JSON-Code
401 Alle APIs Unauthorized Fehler bei der Authentifizierung oder fehlender Authentifizierung. Ungültiger API-Schlüssel, fehlender x-apikey-Header
403 Alle APIs Verboten Gültige Anmeldeinformationen, aber unzureichende Berechtigungen. API-Schlüssel verfügt nicht über erforderliche Berechtigungen
403 Nur durchsuchen Verboten Inhalt gefiltert oder URL ausgeschlossen. Url, die durch Richtlinie oder gefilterte Inhalte blockiert wird
404 Alle APIs Nicht gefunden Pfad nicht gefunden. Falsch geschriebener oder nicht unterstützter Endpunktpfad
404 Nur durchsuchen Nicht gefunden Das Dokument wurde nicht gefunden. Ungültige oder nicht zugängliche URL
410 Alle APIs Nicht vorhanden (Gone) HTTPS erforderlich. Anforderung über HTTP anstelle von HTTPS
415 Alle APIs Nicht unterstützter Medientyp Der Inhaltstyp wird nicht unterstützt. Fehlende oder falsche content-type Kopfzeile
429 Alle APIs Zu viele Anforderungen Das Ratenlimit wurde überschritten. Für die Suche mit granularen Fehlercodes wird auch zurückgegeben, wenn zu viele On-Demand-Durchforstungen angefordert werden. Zu viele Anforderungen im Zeitfenster oder übermäßige Live-Durchforstungsanforderungen
430 Nur durchsuchen Serverfehler Zu viele On-Demand-Durchforstungen (Legacyfehlercodes). Übermäßige Live-Durchforstungsanforderungen
500 Alle APIs Interner Serverfehler Unerwarteter Serverfehler. Temporäres Serverproblem
520 Nur durchsuchen Fehler bei der Inhaltsverarbeitung Die Seite wurde abgerufen, aber es konnten keine verwendbaren Inhalte erstellt werden. Fehler bei der Dokumentverarbeitung oder timeout oder dynamisches Rendering
523 Nur durchsuchen Durchforstung abgebrochen Die URL hat keine Inhalte erzeugt, da die Durchforstung aufgrund des eingeschränkten Websitedurchforstungskontingents nicht erfolgreich war. Begrenztes Durchforstungskontingent für den Quellhost
524 Nur durchsuchen Durchforstungstimeout Die URL hat keinen Inhalt erzeugt, da die Durchforstung timeout war. Timeout des Remotehosts

Statuswerte 520, 523 und 524 sind Teil der granularen Browse-Fehlercodes, die standardmäßig aktiviert sind.

Struktur von Fehlerantworten

Alle Fehlerantworten folgen diesem Schema:

Feld Typ Description
errorCode string Eine detailliertere Fehlerkategorie, die hilft, den Typ des Fehlers zu identifizieren.
errorCategory string Allgemeine Kategorie: UserError (clientseitige / nicht retryable) oder SystemError (serverseitige / wiederholungsfähig).
userMessage string Für Menschen lesbare Fehlerbeschreibung.
technicalDetails String (optional) Zusätzliche technische Informationen oder Parameterüberprüfungsdetails für das Debuggen.
retryAfter String (optional) Wiederholen Sie die Anleitungen. For AuthUserThrottled, AuthUserDailyUsageExceeded, , InternalServerError, and ScopeFailedToApply, a duration with an "s" suffix (for example, "60s"). For Browse granular errors, including TooManyOnDemandCrawls (429), an ISO 8601 UTC timestamp (for example, "2026-10-30T01:01:00Z") that is the earliest time to retry. Wird ausgelassen, wenn keine Wiederholungsanleitungen angewendet werden.
requestId String (optional) Eindeutiger Bezeichner für die Anforderung.
traceId string Verteilte Ablaufverfolgungs-ID zum Debuggen und Microsoft Unterstützung.

Note

retryAfter verwendet zwei Formate. AuthUserThrottled, AuthUserDailyUsageExceeded, InternalServerErrorund ScopeFailedToApply Antworten verwenden eine Dauer, z "60s". B. . Durchsuchen von 202 Accepted Antworten und Granulare Fehler durchsuchen verwenden einen absoluten ISO 8601 UTC-Zeitstempel wie z "2026-10-30T01:01:00Z". B. . Der HTTP-Status allein bestimmt nicht das Format: TooManyOnDemandCrawls Gibt 429 zurück, verwendet jedoch einen Zeitstempel. Die Wiederholungslogik sollte beide Formate behandeln.

Note

202 Accepted Antworten (z. B. Durchsuchen von Livedurchforstungsumfragen) sind keine Fehlerantworten und verwenden das obige Fehlerschema nicht. Sie enthalten einen retryAfter Zeitstempel, der angibt, wann die Anforderung erneut versucht werden soll.

Beispielfehlerantwort:

{
  "errorCode": "HandlerInvalidInput",
  "errorCategory": "UserError",
  "userMessage": "Invalid input provided. Please check your request parameters.",
  "technicalDetails": "Parameter validation failed: maxResults=100 exceeds maximum=50",
  "requestId": "req_abc123",
  "traceId": "trace_xyz789"
}

Fehlercodesreferenz

Fehler bei der Anforderungsüberprüfung

Fehlercode HTTP-Status Category Description
RequestInvalidFormat 400 UserError Falsch formatierter JSON-Textkörper oder ungültige Anforderungsnutzlaststruktur.
RequestInvalidMethod 400 UserError Ungültiger Methoden- oder Toolname, der in der Anforderung angegeben ist.
HandlerInvalidInput 400 UserError Ungültige Eingabeparameterwerte (z. B. leere Abfrage, maxResults außerhalb des Bereichs [1, 50], ungültige Enumerationswerte). Für Durchstöberungsanforderungen fehlen, query leer oder länger als 1000 Zeichen.
RequestBlockedHeader 400 UserError Die Anforderung enthält einen blocklisteten Debug-/Variant-Header (z. B. X-Augmentations, , X-DebugOptions). X-XapHostOverride Verwenden Sie stattdessen dokumentierte URL-Parameter (?p1=, ?debugoptions=, ?atlahostname=).
RequestUnsupportedMediaType 415 UserError Die content-type Kopfzeile fehlt oder nicht application/json.
MethodNotAllowed 405 UserError HTTP-Methode ist für die Route nicht zulässig (z. B. GET auf einem NUR POST-Endpunkt).

Authentifizierungs- und Autorisierungsfehler

Fehlercode HTTP-Status Category Description
AuthNoToken 401 UserError Authentifizierung erforderlich. Kein Bearertoken oder API-Schlüssel bereitgestellt.
AuthTokenParse 401 UserError Ungültiges Authentifizierungstokenformat oder Tokenanalysefehler.
AuthInvalidApiKey 401 UserError Der bereitgestellte API-Schlüssel ist ungültig oder nicht erkannt.
AuthenticationFailed 401 UserError Allgemeiner Authentifizierungsfehler.
AuthExpiredTrial 401 UserError Der Testzeitraum ist abgelaufen. Bitte aktualisieren Sie Ihren Schlüssel.
AuthMissingEntryId 400 UserError Fehlende Anwendungsidentität/Eintrags-ID im Anforderungskontext.
AuthAppIdSelectionRequired 400 UserError Ihre Identität ist mehreren Anwendungen zugeordnet. Geben Sie die Zielanwendung mithilfe des APPID Abfrageparameters an. Weitere Informationen finden Sie unter Aufrufen mehrerer AppID.
AuthUnauthorizedEntryId 401 UserError Nicht autorisierte Eintrags-ID. Die Anwendungsidentität konnte nicht aufgelöst werden, oder der APPID Abfrageparameter wurde mit API-Schlüsselauthentifizierung gesendet.
AuthUnauthorizedAppId 403 UserError Die angegebene APPID Angabe ist ihrer Identität nicht zugeordnet.
AuthUnauthorizedService 403 UserError Der Anrufer wird authentifiziert, aber nicht autorisiert, um auf den angeforderten Dienst/die angeforderte Vertikale zuzugreifen.
AuthBatchEndpointRequired 403 UserError Die Anwendung ist erforderlich, um den Batchendpunkt (X-FD-Batch: 1) für die Websuche zu verwenden.
AuthMcpWebForbidden 403 UserError Die Anwendung darf das MCP-Tool web nicht verwenden.
AuthContentFormatForbidden 403 UserError Diese Anwendung hat nur Zugriff auf Passagen. Verwenden Sie contentFormatpassage. Siehe Passagen und Inhaltsformate.

Fehler beim Einschränken von Raten

Fehlercode HTTP-Status Category Description
AuthUserThrottled 429 UserError Die Anforderungshäufigkeit überschreitet das Ratelimit Ihrer AppID. Markieren Sie retryAfter.
AuthUserDailyUsageExceeded 429 UserError Das tägliche Anforderungskontingent wurde erreicht (Setzt um 00:00 UTC zurück). Markieren Sie retryAfter.

Fehler im benannten Bereich

Wenn scopeName angegeben wird, wird standardmäßig truefolgendes angegeben: failOnMissingScope wenn sie nicht angegeben oder nullangegeben wird. Wenn der Dienst meldet, dass der erforderliche Bereich nicht angewendet werden konnte, geben Websuche, Nachrichtensuche und Auto den folgenden HTTP-Status und errorCode in der öffentlichen REST-Antwort zurück:

Bedingung Fehlercode HTTP-Status Action
Die Bereichssuche bestätigt, dass der benannte Bereich fehlt. HandlerInvalidInput 400 Überprüfen Sie den Namen, das ausgewählte Abrechnungskonto der Web IQ AppID und ob der neue Bereich weitergegeben wurde.
Der Bereich kann aus einem anderen Grund nicht angewendet werden, einschließlich eines Abruffehlers oder einer unbekannten Ursache. ScopeFailedToApply 500 Folgen Sie den Wiederholungsanleitungen der Antwort mit gebundener Backoff-Funktion. wenden Sie sich an den Support, wenn der Fehler weiterhin besteht. Gehen Sie nicht davon aus, dass der Bereichsname ungültig ist.

Ein neu erstellter Bereich kann aus der Partition oder dem Replikat fehlen, die die Anforderung verarbeitet, während die Verteilung ausgeführt wird. Ändern Sie sich nicht, failOnMissingScope: false um einen Fehler zu umgehen, wenn ihre Anwendung bereichsbezogene Ergebnisse erfordert: false Ermöglicht eine Suche des gesamten Indexes ohne den Bereich.

Bei false, wird eine gemeldete erfolglose Anwendung wie scopeApplied: false in der normalen Suchantwort zurückgegeben. Eine gemeldete erfolgreiche Anwendung lautet scopeApplied: true; null übereinstimmende Dokumente sind kein Bereichsanwendungsfehler. Das Feld wird weggelassen, wenn kein Anwendungsergebnis gemeldet wird. Ohne scopeName, failOnMissingScope hat keine Wirkung.

Weder scopeApplied: true noch failOnMissingScope: true garantiert, dass die neueste Definition verwendet wurde. Siehe Bereichsüberprüfung und Rollout.

API-spezifische Fehler durchsuchen

Granulare Fehlercodes sind standardmäßig für "Durchsuchen" aktiviert. Sie identifizieren den spezifischen Grund, warum eine Seite nicht zurückgegeben werden konnte, z. B. Inhaltsfilterung, fehlendes Dokument oder Durchforstungsfehler, und fügen ggf. Wiederholungsanleitungen ein. Es ist keine Opt-In- oder Supportanfrage erforderlich.

Granulare und Legacycodes verwenden die Standardmäßige Fehlerantwortstruktur. Hier nicht aufgeführte Suchfehler werden als (HTTP 500) gemeldet InternalServerError .

Fehlercodes für legacy-Durchsuchen

Diese Codes wurden verwendet, bevor granulare Fehlercodes zum Standard wurden. Sie werden bei der Behandlung älterer Antworten zur Referenz aufgelistet.

Fehlercode HTTP-Status Category Description
BrowseApiDocNotFound 404 UserError Das Dokument wurde nicht gefunden. Für die angegebene URL sind keine Inhalte verfügbar.
BrowseApiIsFilteredOut 403 UserError Das Ergebnis wurde durch Inhaltsrichtlinie, jugendfreie Filterung, Zugriffsbeschränkungen oder Domäneneinschränkungen verworfen.
BrowseApiIsUrlExcluded 403 UserError Die Ziel-URL wird durch robots.txt- oder Durchforstungsausschlussrichtlinien ausgeschlossen.
BrowseApiTooManyOnDemandCrawls 430 UserError Zu viele On-Demand-Live-Durchforstungsanforderungen werden ausgeführt. Verringern Sie die Live-Durchforstungsrate.

Granulare Browse-Fehlercodes

Fehlercode HTTP-Status Category Typisch retryAfter userMessage Empfohlene Maßnahme
InvalidUrl 400 UserError Weggelassen Die angeforderte URL ist ungültig. Korrigieren Sie die URL, bevor Sie den Vorgang wiederholen.
NotSupported 400 UserError Weggelassen Die angeforderte URL wird nicht unterstützt. Verwenden Sie eine URL, die auf ein unterstütztes Webdokument verweist.
URLFilteredOutSpamAdult 403 UserError Ca. 24 Stunden Die angeforderte URL wurde nach Spam- oder Erwachsenenrichtlinien gefiltert. Die Seite kann nicht zurückgegeben werden. Versuchen Sie es nicht vor retryAfter.
URLFilteredOutEncumbrance 403 UserError Ca. 24 Stunden Die angeforderte URL wurde nach Inhaltsbeschränkungen gefiltert. Der Herausgeber oder die Websiterichtlinie, z. B. Roboterrichtlinien oder Paywall-Regeln, lässt die Rückgabe des Inhalts nicht zu. Versuchen Sie es nicht vor retryAfter.
URLFilteredOutSource403Forbidden 403 UserError Ca. 24 Stunden Die Quelle hat den Zugriff auf die angeforderte URL verweigert. Die Quellwebsite hat HTTP 403 zurückgegeben. Versuchen Sie es nicht vor retryAfter.
BrowseApiIsFilteredOut 403 UserError Ca. 24 Stunden, wenn angegeben Die angeforderte URL wurde herausgefiltert. Wird zurückgegeben, wenn eine Seite aus einem Grund gefiltert wird, für den kein spezifischerer Code abgedeckt wird. Versuchen Sie es nicht vor retryAfter.
DocNotFound 404 UserError Ausgelassen, es sei denn, vom Durchforstungsdienst bereitgestellt Das angeforderte Dokument wurde nicht gefunden. Überprüfen Sie die URL, oder legen liveCrawl Sie auf "Fallback" fest, um eine Live-Durchforstung anzufordern.
TooManyOnDemandCrawls 429 UserError Wenn vom Durchforstungsdienst bereitgestellt Zu viele On-Demand-Durchforstungen wurden angefordert. Verringern Sie die Live-Durchforstungsrate. Wenn retryAfter vorhanden, warten Sie bis zu diesem Zeitpunkt, bevor Sie den Vorgang wiederholen.
FailedNoContent 520 SystemError Ca. 5 Minuten Fehler bei der Dokumentverarbeitung oder Veröffentlichung, um verwendbare Inhalte zu erzeugen. Wiederholen Sie den Vorgang nach retryAfter.
DynamicRenderingTimeout 520 SystemError Ca. 5 Minuten Timeout des dynamischen Seitenrenderings. Wiederholen Sie den Vorgang nach retryAfter, oder wiederholen Sie den Vorgang ohne renderDynamicPages.
ProcessingTimeout 520 SystemError Ca. 5 Minuten Timeout für die Dokumentverarbeitung. Wiederholen Sie den Vorgang nach retryAfter.
PolitenessCancellation 523 SystemError Ca. 5 Minuten Die Durchforstung wurde abgebrochen, um die Durchforstungsgrenzwerte des Quellhosts einzuhalten. Die URL hat keine Inhalte erzeugt, da die Durchforstung aufgrund des eingeschränkten Websitedurchforstungskontingents nicht erfolgreich war. Wiederholen Sie den Vorgang nach retryAfter.
HostCrawlTimeout 524 SystemError Ca. 5 Minuten Timeout des Quellhost-Durchforstungstermins. Die URL hat keinen Inhalt erzeugt, da das Timeout der Durchforstung nicht ausgeführt wurde: Der Remotehost reagierte nicht rechtzeitig. Wiederholen Sie den Vorgang nach retryAfter.

Wenn eine Wiederholungsverzögerung angewendet wird, enthält retryAfter die Antwort den UTC-Zeitstempel ISO 8601 im Format yyyy-MM-ddTHH:mm:ssZ, z. B "retryAfter": "2026-10-30T01:01:00Z". . . Versuchen Sie es nicht vor diesem Zeitpunkt erneut. Wenn retryAfter dieser Parameter nicht angegeben wird, gelten keine Wiederholungsanleitungen.

Beispiel für eine präzise Fehlerantwort:

{
  "errorCode": "URLFilteredOutEncumbrance",
  "errorCategory": "UserError",
  "userMessage": "The requested URL was filtered by content restrictions.",
  "retryAfter": "2026-10-31T01:00:00Z",
  "traceId": "0123456789abcdef0123456789abcdef"
}

Durchstöberungsfehler

Diese Fehler gelten für Browse-Anforderungen mit contentFormat: "passage", einschließlich Anforderungen von Anwendungen ohne vollständigen Dokumentzugriff, für die "Passage" das Standardformat ist. Siehe Durchsuchen von Passagenanforderungen.

Bedingung Fehlercode HTTP-Status userMessage
query Fehlende, leere Leerzeichen, nur Leerzeichen oder länger als 1000 Zeichen HandlerInvalidInput 400 Ungültige Eingabe. Bitte überprüfen Sie Ihre Anforderungsparameter.
Eine Anwendung ohne vollständige Dokumentzugriffsanforderungen text, htmloder markdown AuthContentFormatForbidden 403 Diese Anwendung hat nur Zugriff auf Passagen. Verwenden Sie contentFormat "passage".

Alle anderen Browse-Ergebnisse für Passagenanforderungen verwenden dieselben Statuscodes und Fehlercodes wie text, htmlund markdown Anforderungen. Dazu gehören gefilterte Seiten, Dokumente, die nicht gefunden wurden, eine ausstehende Live-Durchforstung (202 Accepted) und Durchforstungsfehler.

Dienst- und Infrastrukturfehler

Fehlercode HTTP-Status Category Wiederholbar Description
InternalServerError 500 SystemError Ja (30s) Interner Serverfehler.

Häufige Fehlerszenarien

Authentifizierungsfehler (401, 403)

Symptom: Fehler bei der Authentifizierung oder unzulässiger Zugriff

Lösungen :

  • Überprüfen, ob der API-Schlüssel korrekt ist und in den x-apikey Header eingeschlossen ist
  • Überprüfen Sie, ob Ihr API-Schlüssel nicht abgelaufen ist.
  • Stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen für den Endpunkt verfügen.
  • Wenden Sie sich an Ihren Microsoft Vertreter, wenn Probleme weiterhin bestehen.

Beispiel:

# Correct authentication
curl -X POST "https://api.microsoft.ai/v3/search/web" \
  -H "x-apikey: your-valid-key-here" \
  -H "content-type: application/json" \
  -d '{"query": "test"}'

Zinsbegrenzung (429)

Symptom: Satzgrenze überschritten oder tageskontingent überschritten (AuthUserThrottled oder AuthUserDailyUsageExceeded)

Anforderungen über dem Zinslimit Ihrer AppID geben HTTP 429 zurück. Ihr Zinslimit wird im Web IQ-Portal angezeigt.

Lösungen :

  • Exponentielle Backoff-Wiederholungslogik implementieren
  • Warten Sie auf das retryAfter Intervall in der Fehlerantwort (z. B. "60s"), bevor Sie den Vorgang wiederholen.
  • Verringern der Anforderungshäufigkeit
  • Beachten Sie, dass tägliche Kontingentgrenzen (AuthUserDailyUsageExceeded) täglich um 00:00 UTC zurückgesetzt werden
  • Um eine höhere Grenze anzufordern, wenden Sie sich an den Web IQ Support

Beispielantwort:

{
  "errorCode": "AuthUserThrottled",
  "errorCategory": "UserError",
  "userMessage": "Rate limit exceeded. Please reduce your request frequency.",
  "retryAfter": "60s",
  "requestId": "req_123",
  "traceId": "trace_456"
}

Ungültige Parameter (400)

Symptom: Ungültige Anforderung aufgrund ungültiger Parameter

Allgemeine Probleme:

  • Erforderliche Felder fehlen (z. B. query Parameter)
  • Parameterwerte außerhalb des Bereichs (z. B. maxResults> 50)
  • Ungültige Parametertypen (z. B. Zeichenfolge anstelle ganzzahliger Zahlen)
  • Nicht unterstützte Parameterwerte (z. B. ungültig contentFormat)

Lösungen :

  • Überprüfen, ob alle erforderlichen Parameter vorhanden sind
  • Überprüfen von Parameterwerten anhand dokumentierter Einschränkungen
  • Sicherstellen der richtigen JSON-Formatierung

Server- und Infrastrukturfehler (500)

Symptom: Unerwarteter interner Server- oder Upstreamdienstfehler (InternalServerError)

Lösungen :

  • Überprüfen Sie das retryAfter Feld (standardeinstellung) "30s"und wiederholen Sie die Anforderung nach dem Warten.
  • Wiederholungsversuche mit exponentiellem Backoff und Jitter implementieren
  • Wenn das Problem weiterhin besteht, wenden Sie sich an den support Microsoft mit der traceId in der Antwort bereitgestellten

Beispielantwort:

{
  "errorCode": "InternalServerError",
  "errorCategory": "SystemError",
  "userMessage": "The service is temporarily unavailable. Please try again later.",
  "technicalDetails": "An internal service error occurred. Please contact support if the issue persists.",
  "retryAfter": "30s",
  "traceId": "trace_456"
}

Akzeptierte API-Antwort durchsuchen (202)

Symptom: Akzeptierte Antwort (202) mit url und retryAfter Feldern im Antworttext

Erläuterung: Wenn liveCrawl "Fallback" ist und die URL nicht im Index gefunden wird, kann die API eine Durchforstung asynchron starten und 202 Akzeptiert zurückgeben. Die Live-Durchforstung unterliegt Publisher-Höflichkeitseinschränkungen und -verfügbarkeit; "Fallback" garantiert keine tatsächliche Durchforstung. Das gleiche Verhalten gilt für alle contentFormat, einschließlich passage.

Handhabung:

  1. Überprüfen Sie den HTTP-Status 202.
  2. Lesen retryAfter aus dem Antworttext. Es handelt sich um einen UTC-Zeitstempel (z. B "2026-10-30T01:01:00Z". ISO 8601), der die früheste Zeit für die Wiederholung ist.
  3. Warten Sie bis zu dieser Zeit.
  4. Senden Sie dieselbe Anforderung erneut. Das url Feld enthält die URL, die angefordert werden soll. Standardmäßig wird die von Ihnen angeforderte URL verwendet.
  5. Beschränken Sie die Anzahl der Abrufversuche. Eine Durchforstung, die schließlich nicht abgeschlossen werden kann, gibt einen Fehler zurück, z HostCrawlTimeout . B. (524) oder FailedNoContent (520).
# Initial request
curl -X POST "https://api.microsoft.ai/v3/browse" \
  -H "x-apikey: your-key" \
  -H "content-type: application/json" \
  -d '{"url": "https://example.com", "contentFormat": "passage", "query": "information about this domain", "liveCrawl": "fallback"}'

# Example response when the URL isn't indexed: 202 Accepted with "retryAfter": "2026-10-30T01:01:00Z"
# Wait until that time, then send the same request again

Bewährte Vorgehensweisen

  1. Statuscodes immer überprüfen – Kein Erfolg annehmen
  2. Use traceId for support - Include traceId when contacting support
  3. Implementieren von Wiederholungslogik – Verwenden eines exponentiellen Backoffs für vorübergehende Fehler
  4. Behandeln von 202 Antworten – Für die Such-API mit Live-Durchforstung warten Sie bis zur retryAfter Zeit, und wiederholen Sie den Vorgang.
  5. Behandeln Sie beide retryAfter Formate : Verwenden Sie die Dauer für AuthUserThrottled, AuthUserDailyUsageExceeded, InternalServerErrorund ScopeFailedToApply, und den ISO 8601-Zeitstempel für Browse 202 und granulare Fehler, einschließlich TooManyOnDemandCrawls (429)
  6. Überprüfen vor dem Senden – Überprüfen Von Parametern lokal, um 400 Fehler zu vermeiden
  7. Nur HTTPS verwenden – HTTP-Anforderungen geben 410 Fehler zurück.