Die URL verweist auf einen privaten Host oder einen Loopback-Host bzw. leitet auf einen solchen weiter. Verweisen Sie mit der URL auf einen öffentlich erreichbaren Host.
Fehler in API-Referenzquellen beheben
Wenn eine API-Referenz ihre Spezifikation nicht abrufen, aktualisieren oder verarbeiten kann, wird einer der folgenden Fehler angezeigt. Suchen Sie Ihre Meldung, wenden Sie die entsprechende Lösung an und aktualisieren Sie die Referenz anschließend erneut über den Tab Source. Wie Sie eine Referenz öffnen und aktualisieren, wird unter API-Referenzquellen aktualisieren beschrieben.
Fehler bei der Spezifikations-URL
Host der API-Spezifikations-URL blockiert: <hostname>
Host der API-Spezifikations-URL konnte nicht aufgelöst werden: <hostname>
Der Hostname kann nicht aufgelöst werden. Überprüfen Sie die URL auf Tippfehler.
Nur HTTP(S)-URLs für API-Spezifikationen sind zulässig
Die URL verwendet ein anderes Protokoll als HTTP oder HTTPS. Verwenden Sie eine HTTP- oder HTTPS-URL.
Die API-Spezifikations-URL darf keine eingebetteten Anmeldedaten enthalten
Die URL enthält einen Benutzernamen und ein Passwort. Entfernen Sie die Anmeldedaten aus der URL.
Spezifikation von <host> konnte nicht abgerufen werden (HTTP <status>)
Der Server hat einen HTTP-Fehler zurückgegeben, zum Beispiel 410 Gone. Dies ist die im Tab Source angezeigte Meldung. Überprüfen Sie, ob die URL weiterhin die Spezifikation bereitstellt.
API-Spezifikation konnte nicht abgerufen werden (zu viele Weiterleitungen, max. 5)
Die URL wird mehr als fünfmal weitergeleitet. Verweisen Sie mit der URL direkt auf die Spezifikation.
Die URL hat weder ein Spezifikationsdokument noch ein GraphQL-Schema zurückgegeben. Verweisen Sie mit der URL auf eine OpenAPI-Datei, eine GraphQL-SDL-Datei oder einen GraphQL-Endpunkt mit aktivierter Introspektion.
Die URL hat Inhalte bereitgestellt, die wir nicht als Spezifikation lesen können. Verweisen Sie mit der URL auf eine OpenAPI-Datei, eine GraphQL-SDL-Datei oder einen GraphQL-Endpunkt mit aktivierter Introspektion.
Fehler bei der Spezifikationsgröße
Die API-Spezifikation überschreitet das Limit von 15 MB.
Die Spezifikationsdatei ist größer als 15 MB. Verkleinern Sie die Datei auf weniger als 15 MB und versuchen Sie es erneut.
GitHub-Fehler
Authentifizierung bei GitHub nicht möglich. Versuchen Sie, die Integration erneut zu verbinden.
Die GitHub-Verbindung kann nicht mehr authentifiziert werden. Verbinden Sie die GitHub-Integration erneut und aktualisieren Sie anschließend die Referenz. Weitere Informationen finden Sie unter GitHub-Integration.
Der GitHub-Pfad muss auf eine Datei verweisen
Der konfigurierte Pfad verweist auf ein Verzeichnis. Verweisen Sie mit dem Pfad auf die Spezifikationsdatei selbst.
Datei im GitHub-Repository unter diesem Ref nicht gefunden
Die Datei ist unter dem konfigurierten Ref nicht vorhanden. Überprüfen Sie den Pfad und den Ref oder verschieben Sie die Datei und aktualisieren Sie die Referenz.
Die GitHub-Verbindung kann dieses Repository nicht lesen
Die GitHub-Verbindung hat keinen Zugriff auf das Repository. Gewähren Sie der Verbindung in GitHub Zugriff auf das Repository und aktualisieren Sie anschließend die Referenz.
Diese Datei konnte nicht aus GitHub gelesen werden.
Dies ist die Fallback-Meldung, wenn die Datei nicht gelesen werden konnte. Überprüfen Sie die Verbindung, den Pfad und den Ref und aktualisieren Sie anschließend die Referenz.
Fehler bei der Verarbeitung
Verarbeitung fehlgeschlagen
Bei der Verarbeitung ist ein Fehler aufgetreten, während wir die Spezifikation gelesen und indiziert haben. Die Referenz bleibt bearbeitbar. Ersetzen Sie daher die Spezifikation und versuchen Sie es erneut.