Zum Hauptinhalt springen

Callbacks

Die iframe kommuniziert mit der Host-Anwendung durch Posting von Callback-Nachrichten. Jeder Callback hat eine stabile Struktur und wird über einen Transport geliefert, der davon abhängt, wo die iframe eingebettet ist.

Transporte pro Plattform​

  • Web: Transport window.postMessage; Listener window.addEventListener("message", ...).
  • iOS: Transport webkit message handler (bridge); Listener WKScriptMessageHandler.
  • Android: Transport injiziertes JS-Objekt (legitHealthJsObject); Listener WebViewCompat.postWebMessage.

Für den Embedding-Code auf jeder Plattform siehe Abschnitt "Plattformen".

Callback-Katalog​

  • analysis_completed: wird ausgelöst, wenn das Bild verarbeitet wurde und der Bericht bereit ist. Payload enthält die id des Berichts.
  • invalid_company_key: wird ausgelöst, wenn die iframe nicht geladen werden konnte, weil der company-Schlüssel ungültig ist. Payload enthält die id (den fehlerhaften Schlüssel).
  • image_rejected: wird ausgelöst, wenn ein hochgeladenes Bild die Qualitätsprüfung nicht besteht. Payload ist ein payload[]-Array mit Ablehnungsgründen.

Alle drei Nachrichten teilen denselben Umschlag:

{
  message: "<message_name>",
  id: "<resource or key id>",
  payload: <message-specific data>  // wenn anwendbar
}

Die folgenden Seiten dokumentieren jeden Callback im Detail zusammen mit dem plattformspezifischen Code, den Sie benötigen, um ihn zu empfangen.

Nächste Schritte​

  • Plattformspezifischen Code sehen? Gehen Sie zum Abschnitt "Plattformen".
  • Bereit zum Abrufen des Berichts? Siehe Abschnitt "Ausgabe: API-Endpunkt".
  • Möchten Sie die Ergebnisse verarbeiten? Siehe Abschnitt "Ausgabe".