Zum Hauptinhalt springen
Version: 1.x

API03001: Ungültiges Anforderungsformat

Was das bedeutet​

Die an den Server gesendete Anfrage war nicht im erwarteten Format. Der Server konnte nicht verstehen, was das POS angefordert hat, da die Anforderungsstruktur inkorrekt war.

Häufige Ursachen​

  • Beschädigte Daten — Daten wurden vor dem Senden beschädigt
  • Softwarefehler — Ein Bug in der POS-Anwendung
  • Proxy-Interferenzen — Ein Proxy oder eine Firewall hat die Anfrage geändert
  • Probleme mit der Zeichencodierung — Sonderzeichen wurden nicht richtig codiert

Serverfehler Zuordnung​

Dieser Fehlercode wird ausgelöst, wenn der Server zurückgibt:

ServercodeQuelle
HTTP 400Jede Serverantwort (Fallback)

So beheben Sie das Problem​

1. Wiederholen Sie die Aktion​

Manchmal handelt es sich um einen einmaligen Aussetzer:

  • Warten Sie einen Moment und versuchen Sie es erneut
  • Aktualisieren Sie das POS und versuchen Sie es erneut

2. Überprüfen Sie auf Sonderzeichen​

Wenn Sie Daten mit Sonderzeichen eingeben:

  • Versuchen Sie, Emojis oder ungewöhnliche Symbole zu entfernen
  • Verwenden Sie Standardzeichen für Produktnamen usw.

3. Aktualisieren Sie das POS​

Stellen Sie sicher, dass Sie die neueste Version verwenden:

  • Überprüfen Sie auf App-Updates
  • Aktualisieren Sie das WCPOS-Plugin auf Ihrem Server

4. Überprüfen Sie die Netzwerkkonfiguration​

Wenn Sie hinter einem Proxy sind:

  • Überprüfen Sie, ob der Proxy Anfragen verändert
  • Überprüfen Sie die Firewall-Regeln
  • Versuchen Sie den Zugriff von einem anderen Netzwerk aus

5. Melden Sie das Problem​

Wenn dies konsistent auftritt:

  • Notieren Sie, welche Aktion den Fehler auslöst
  • Überprüfen Sie die Browser-Konsole auf Details (Webversion)
  • Berichten Sie auf GitHub mit Reproduktionsschritten
  • API03002 — Fehlende erforderliche Parameter
  • API03003 — Ungültiger Parameterwert