Fehlercodes
Fehlercodes haben zwei Ebenen. Der äußere code gibt das Ergebnis auf API-Ebene wieder, data.bizCode das Geschäftsergebnis. Ein Aufruf ist nur dann erfolgreich, wenn sowohl code == 0 als auch data.bizCode == 0 gilt. Siehe Einheitliche Antwortstruktur.
API-Fehlercodes (code)
| code | Beschreibung | Empfehlung |
|---|---|---|
| 0 | Erfolg | — |
| 401 | Authentifizierung fehlgeschlagen | Die genaue Ursache finden Sie in der folgenden Tabelle |
| 429 | Too Many Requests | Verringern Sie die Aufrufrate und versuchen Sie es erneut; jede API erlaubt bis zu 10 Anfragen / Sekunde |
Ursachen für 401
| Meldung | Bedeutung | Empfehlung |
|---|---|---|
| Missing required headers | Ein erforderlicher Anfrage-Header fehlt | Prüfen Sie, ob alle Allgemeinen Anfrage-Header vorhanden sind |
| Invalid timestamp format | Das Format des Zeitstempels ist falsch | X-Timestamp muss ein Zeitstempel in Sekunden sein |
| Request timestamp expired | Der Zeitstempel der Anfrage ist abgelaufen | Synchronisieren Sie die Serveruhr und senden Sie die Anfrage erneut |
| Invalid nonce format | Die Nonce entspricht nicht der Formatregel | Muss ^[A-Za-z0-9]{16,32}$ entsprechen |
| Nonce already used or validation failed | Die Nonce wurde bereits verwendet oder ist bei der Prüfung durchgefallen | Verwenden Sie für jede Anfrage eine neue Zufallszeichenfolge und nie dieselbe erneut |
| appId not found | Die appId existiert nicht | Prüfen Sie APP-ID |
| appId is disabled | Die appId wurde deaktiviert | Wenden Sie sich an den technischen Support |
| Signature calculation failed | Die Signaturberechnung ist fehlgeschlagen | Prüfen Sie Ihre Signaturimplementierung; siehe Signaturmechanismus |
| Signature verification failed | Die Signaturprüfung ist fehlgeschlagen | Prüfen Sie die Verkettungsreihenfolge der zu signierenden Zeichenfolge, ob path das Präfix /open-apis enthält und ob timestamp und nonce mit den Headern übereinstimmen |
Geschäftliche Fehlercodes (bizCode)
| bizCode | Beschreibung |
|---|---|
| 0 | Erfolg |
| 10000001 | Ungültige Parameter |
| 10000003 | Zu viele Anfragen. Bitte warten Sie und versuchen Sie es erneut |
| 10000103 | Der Systemdienst ist gestört, bitte wenden Sie sich an den Kundenservice |
| 100027001 | Ungültige Parameter für den Credit-Vorgang |
| 100027003 | Unzureichendes Credit-Guthaben |
| 100041003 | Die Aufgabe zur räumlichen Modellierung existiert nicht |
| 100041004 | Ergebnis der räumlichen Modellierung nicht gefunden |
| 100041006 | Raum nicht gefunden |
| 100041010 | Die AppId hat keine Berechtigung für räumliche Modellierung |
| 100041016 | Aufgabenstatus [Modellierung läuft], Löschen nicht zulässig |
| 100041017 | Die Aufgabe kann im aktuellen Status nicht abgebrochen werden |
Fehlersuche bei fehlgeschlagener Modellierung
Wenn eine Aufgabe in den Status „Modellierung fehlgeschlagen“ (9) wechselt, rufen Sie Paginierte Aufgabenliste oder Aufgabendetails auf und lesen Sie errorCode und failedReason, um die Ursache zu ermitteln.
Diese beiden Felder enthalten Fehlerinformationen aus der Modellierungspipeline und verwenden einen anderen Wertebereich als der obige bizCode. Wenn ein API-Aufruf erfolgreich ist, die Modellierung der Aufgabe aber fehlschlägt, ist bizCode trotzdem 0.