Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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-apikeyHeader 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
retryAfterIntervall 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.
queryParameter) - 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
retryAfterFeld (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
traceIdin 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:
- Überprüfen Sie den HTTP-Status 202.
- Lesen
retryAfteraus 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. - Warten Sie bis zu dieser Zeit.
- Senden Sie dieselbe Anforderung erneut. Das
urlFeld enthält die URL, die angefordert werden soll. Standardmäßig wird die von Ihnen angeforderte URL verwendet. - 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) oderFailedNoContent(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
- Statuscodes immer überprüfen – Kein Erfolg annehmen
- Use traceId for support - Include traceId when contacting support
- Implementieren von Wiederholungslogik – Verwenden eines exponentiellen Backoffs für vorübergehende Fehler
-
Behandeln von 202 Antworten – Für die Such-API mit Live-Durchforstung warten Sie bis zur
retryAfterZeit, und wiederholen Sie den Vorgang. -
Behandeln Sie beide
retryAfterFormate : Verwenden Sie die Dauer fürAuthUserThrottled,AuthUserDailyUsageExceeded,InternalServerErrorundScopeFailedToApply, und den ISO 8601-Zeitstempel für Browse 202 und granulare Fehler, einschließlichTooManyOnDemandCrawls(429) - Überprüfen vor dem Senden – Überprüfen Von Parametern lokal, um 400 Fehler zu vermeiden
- Nur HTTPS verwenden – HTTP-Anforderungen geben 410 Fehler zurück.