Fehlercodes
Dieses Dokument gilt für das eigenständige MA Web SDK der Version 2.x.
Definition von Client-seitigen Fehlercodes
Die vom Web SDK lokal erzeugten Callback-Codes haben die folgenden drei Werte:
| Code | Beschreibung | Detaillierte Erklärung |
|---|---|---|
| 0 | Anfrage erfolgreich | Die Schnittstellenanfrage war erfolgreich (message ist immer success) |
| -1 | Anfrage fehlgeschlagen | Lokale Parameterprüfung fehlgeschlagen, SDK nicht bereit (kein init / keine RID/EUID erhalten), Netzwerkfehler, Antwort nicht auswertbar oder der Server hat eine ungültige Antwort zurückgegeben. Den konkreten Grund entnehmen Sie der message im Callback |
| -8 | Datenerfassung deaktiviert | Ab 2.2.0. Nachdem die Erfassung über den Datenerfassungsschalter deaktiviert wurde, werden die Benutzereigenschaften-Schnittstellen (setProperty, increaseProperty, addProperty, deleteProperty, removeProperty, updateProperty) abgefangen; die Operation wird nicht ausgeführt, message ist immer data collection disabled. Schnittstellen ohne Callback wie Ereignisse und UTM verwerfen die Daten während der Deaktivierung stillschweigend und geben diesen Code nicht zurück |
Häufige lokale -1-messages (werden im englischen Original an die Anwendung zurückgegeben):
| message | Auslösendes Szenario |
|---|---|
invalid argument: enabled must be boolean |
Der Parameter von setDataCollectionEnabled ist kein Boolean |
sdk hasn't registered yet, request will be cancel |
init ist nicht abgeschlossen oder /get-rid war noch nicht erfolgreich; Benutzer-Schnittstellen werden abgefangen |
MA EUID is not a valid Long |
Die lokale EUID fehlt oder ist ungültig (in der Regel war /get-euid nicht erfolgreich) |
identifyAccount fail loginID and mobile are nil |
identifyAccount wurde mit einem leeren Kennungsobjekt aufgerufen (Wortlaut byteweise identisch mit v1) |
user_id cannot be "0" / email format is invalid / phone must be E.164 format (+[1-9] followed by 1-14 digits) usw. |
Die Vorabprüfung der Regeln für Benutzerkennungsfelder ist fehlgeschlagen (Regeln siehe „API-Leitfaden · Benutzerkennung festlegen") |
channelId must be greater than 0 / channel values cannot be empty / channel value element cannot be empty |
Die Parameterprüfung von setChannelValue ist fehlgeschlagen |
userIdentity is invalid: ... |
Alle Felder der userIdentity, die bei einem erneuten init übergeben wurde, sind ungültig (ab 2.1.0 wechselt ein erneutes init mit einem anderen AppKey die Datenquelle und gibt keinen Fehler mehr zurück) |
network exception |
Die Netzwerkanfrage ist fehlgeschlagen oder die Antwort ist ungültig |
Server-seitige Geschäftscodes
Gibt der Server explizit einen geschäftlichen Fehler zurück, fasst das SDK ihn nicht zu -1 zusammen, sondern gibt den code und den Text des Servers unverändert im Callback zurück; daher können im Callback positive codes auftreten.
Server-seitige Geschäftscodes dienen nur der Fehlersuche und gehören nicht zum stabilen externen Vertrag des SDK. Schreiben Sie keine Geschäftsverzweigungen auf Basis konkreter positiver codes; prüfen Sie den Erfolg einheitlich über code === 0 und stellen Sie bei unerwarteten Fehlern code und message im Original dem technischen Support zur Verfügung.
Beim wiederholten Aufruf von init (ab 2.1.0 wird bei jedem Aufruf die EUID erneut abgerufen) werden Fehler bei der erneuten Anfrage der zugehörigen EUID ebenfalls nach der obigen Regel als server-seitige Geschäftscodes unverändert zurückgegeben.
Anhang: Häufige server-seitige Geschäftscodes
Die folgenden Werte dienen nur als Referenz für die Fehlersuche; es wird nicht garantiert, dass sie über SDK- oder Server-Versionen hinweg stabil bleiben:
| Code | Bedeutung |
|---|---|
| 55004 | Ungültiger Geschäftsparameter, z. B. der Kanal-AppKey ist im aktuellen Projekt nicht zugeordnet, die channelId existiert im aktuellen Projekt nicht, der Kanalwert entspricht der MA RID oder updateProperty / removeProperty wird für eine noch nicht definierte object_array-Eigenschaft aufgerufen |
| 55100 | Benutzerregistrierung fehlgeschlagen |
| 55101 | Die Anzahl der Benutzerkennungen überschreitet die Obergrenze |
| 55102 | Es existiert ein ungültiger Benutzereigenschaftsname |
| 55103 | Der Wert der Benutzereigenschaft ist leer |
| 55105 | Der Wert der Benutzerkennung überschreitet 256 Zeichen |
| 55106 | Der Name der Benutzerkennung liegt außerhalb des unterstützten Bereichs |
| 55107 | Der Wert der Benutzerkennung ist leer |
| 55108 | Ungültige EUID, z. B. maEuid und maRid gehören nicht zum selben MA-Benutzer |
| 55110 | Zu viele Anfragen; versuchen Sie es später erneut |
| 55000 | Server-seitiger Systemfehler |
| 40007 | EUID ist leer |
