Sicherheit & Betrieb

SDK Integrationsfehlerbehebung

Diagnostizieren Sie Trading Widget, Agent SDK, Signing, Webhook, Timeout und Umweltprobleme, bevor Sie eine Supportanfrage eskalieren.
Als Markdown anzeigen

Beginnen Sie mit der Umgebung, dem Zeitstempel und der Geschäftskennung für die fehlgeschlagene Operation. Eine strukturierte Überprüfung trennt in der Regel Konfigurationsprobleme von Authentifizierungs-, Netzwerk- und asynchronen Verarbeitungsproblemen.

Empfohlene Diagnosereihenfolge

  1. Bestätigen Sie die betroffene Umgebung und die Basis URL.
  2. Die UTC Zeitspanne und die erste fehlschlagende Anfrage notieren.
  3. Identifizieren Sie das Modul: Trading Widget, Agent SDK, REST API, WebSocket, oder Webhook.
  4. Erfassen Sie die Anfrage-ID, Partnerbenutzer-ID, agentOrderNo, Bestell-ID oder Webhook-Ereignis-ID.
  5. Überprüfen Sie aktuelle Code-, Zugangsdaten-, IP -Whitelist- oder Deployment-Änderungen.
  6. Reproduzieren Sie mit dem kleinsten sicheren Testfall.

Trading Widget Probleme

SymptomWahrscheinliche UrsacheFix
iframe bittet Partner-lokale Domain anbaseUrl fehltPass baseUrl: ‘https://app.6mm.com’.
iframe ist unsichtbar oder sehr kurzDer Elternbehälter hat keine HöheStellen Sie die Behälterhöhe oder Passhöhe ein.
token_provider_missingPartner-Token-Modus hat keinen AnbieterAuthentifizierungtokenProviderhinzufügen.
auth_exchange_failedUngültiger, abgelaufener oder nicht übereinstimmender Embed-TokenÜberprüfe die Backend-Token-Antwort und channelId.

Agent SDK Probleme

SymptomWahrscheinliche UrsacheFix
Unterschrift abgelehntFalsches Geheimnis, Taktdrift oder manuell geänderte signierte FelderLass SDK Signing-Felder generieren und Serverzeit synchronisieren.
Risiko der Bewegung von doppelten MittelnNeue Bestellnummer nach Timeout verwendetAbfrage zuerst nach Original agentOrderNo .
PROCESSING als Misserfolg behandeltOffener Staat missverstandenWarte auf Webhook oder ruf queryOrderan.
Webhook wurde mehrfach verarbeitetVersuche Verhalten ohne Idempotenz erneutFügen Sie Idempotenz-Schlüssel- und Endzustandsprüfungen hinzu.

Beweise zur Festnahme

IntegrationNützliche Belege
Trading WidgetSeite URL, SDK Versionspfad, Browser-Konsole, fehlgeschlagene Netzwerkanfragen, onError Nutzlast und Containerdimensionen.
Agent SDKSDK Sprache/Version, Basis URL, UTC Zeitstempel, Anfrage-ID, agentOrderNo, Antwortcode und bereinigte Protokolle.
WebhookLieferzeit, Ereignis- oder Geschäftsschlüssel, Signaturvalidierungsergebnis, Verarbeitungszustand und bereinigter Rohkörper-Hash.
REST APIMethode, Weg, Umgebung, Anfrage-ID, Antwortcode und bereinigte Parameter.

Fügen Sie niemals Passwörter, Zugriffstoken, API Geheimnisse, vollständige Signaturen, private Schlüssel oder ungeschwärzte persönliche Daten in Diagnostiken ein.

Vor der Eskalation

  • Versuchen Sie es nur, wenn die Operation als sicher dokumentiert ist.
  • Nach einem Timeout sollten Sie die ursprüngliche Unternehmenskennung abfragen, anstatt eine neue zu erstellen.
  • Überprüfen Sie die Systemuhr und die Zugangsdaten auf Signaturfehler.
  • Bewahren Sie den ersten Fehlschlag und spätere Nachversuchsergebnisse.
  • Verwenden Sie die Support Request Template, um einen vollständigen, geschwärzten Bericht zu senden.
Trading Widget Schneller Start

Überprüfen Sie das Laden von Skripten, die Containergröße, die Konfiguration und die Rückrufe.

Geheimnisse & Signieren

Überprüfe Agent SDK Zugangsdaten, Uhren und signierte Felder.

Webhooks & Idempotenz

Überprüfen Sie die Rückrufverifizierung und den Umgang mit doppelten Ereignissen.