Insights / Verbindungen

Softwareverbindungen aufbauen, auf die Sie sich verlassen können

Hinter den meisten Unternehmen tauschen Systeme ständig Informationen untereinander aus. Hier erfahren Sie, was diese Verbindungen zuverlässig macht, erklärt ohne Fachjargon.

· 3 Min. Lesezeit

Schrägseilbrücke über offenem Wasser

Eine API ist einfach die Art und Weise, wie ein Stück Software ein anderes um etwas bittet. Ihr Onlineshop fragt Ihr Warenwirtschaftssystem, wie viele Einheiten noch auf Lager sind. Ihre Buchhaltungssoftware fragt die Bank nach den heutigen Transaktionen. Ein Lagerscanner meldet dem Hauptsystem, dass eine Palette gerade versandt wurde.

Diese Verbindungen beginnen meist klein und praktisch. Aber sobald mehrere Systeme darauf angewiesen sind, werden sie Teil der Geschäftsabläufe. Kleine Unklarheiten, etwa was ein bestimmter Fehler bedeutet oder ob es sicher ist, eine Anfrage zweimal zu senden, führen überall zu Problemen. Zuverlässigkeit beginnt damit, diese Dinge klar zu definieren.

Beschreiben Sie die Aufgabe zuerst in einfachen Worten

Bevor ich Code schreibe, beschreibe ich, wofür die Verbindung eigentlich gedacht ist. Was bittet ein System das andere zu tun? Was muss wahr sein, bevor es geschehen kann? Woher wissen wir, dass es abgeschlossen ist? Was sind die normalen „Nein“-Antworten, wie „nicht auf Lager“, und was zählt als echter Fehler?

Dies hält die Verbindung auf die geschäftliche Aufgabe fokussiert, anstatt darauf, wie die Datenbank heute zufällig aufgebaut ist. Es stellt auch sicher, dass jeder das Gleiche unter demselben Wort versteht. Wenn „abgeschlossen“ an einer Stelle „versandt“ und an einer anderen „bezahlt“ bedeutet, wird irgendwann jemand einen kostspieligen Fehler machen.

Gestalten Sie Fehlermeldungen hilfreich

Wenn etwas abgelehnt wird, sollte die Meldung sagen, was schiefgelaufen ist und was dagegen zu tun ist. „Das Lieferdatum kann nicht in der Vergangenheit liegen“ ist nützlich. „Ein Fehler ist aufgetreten“ ist es nicht.

Unterschiedliche Probleme verdienen unterschiedliche Antworten: fehlende Informationen, ein Datensatz, der nicht existiert, zwei Personen, die gleichzeitig dasselbe ändern, fehlende Berechtigungen oder ein echter Fehler auf Systemseite. Fehlermeldungen sollten auch keine internen Details wie Passwörter oder den Datenbankaufbau preisgeben. Diese gehören in private Protokolle, wo ich genau nachverfolgen kann, was passiert ist.

Planen Sie für Anfragen, die zweimal gesendet werden

Hier ist ein häufiges Problem. Ein System sendet einen Auftrag, die Gegenseite speichert ihn, aber die Antwort geht auf dem Rückweg verloren. Der Absender weiß nicht, ob es geklappt hat, also versucht er es erneut. Jetzt gibt es zwei Aufträge.

Die Lösung besteht darin, jeder Anfrage eine eigene Referenznummer zu geben, damit das empfangende System sagen kann: „Ich habe das bereits“ und einfach das ursprüngliche Ergebnis zurücksendet. Für alles, was Aufträge, Zahlungen oder Lieferungen erstellt, betrachte ich dies als essenziell.

Manche Aufgaben dauern auch eine Weile, wie das Erstellen eines großen Berichts oder das Verarbeiten einer großen Menge von Datensätzen. In diesen Fällen sollte das System sofort mit „erhalten, hier ist eine Referenz zum Überprüfen“ antworten, anstatt den Absender raten zu lassen, ob langes Schweigen Erfolg oder Misserfolg bedeutet.

Ändern Sie es vorsichtig

Sobald andere Systeme von einer Verbindung abhängen, ist eine Änderung ein wenig so, als würde man die Spielregeln mitten im Spiel ändern. Das Entfernen einer Information ist offensichtlich riskant. Das stille Ändern der Bedeutung einer Information kann genauso schlimm und viel schwerer zu erkennen sein.

Wenn Änderungen erforderlich sind, füge ich nach Möglichkeit die neue Version neben der alten hinzu, gebe allen Bescheid und setze einen Zeitplan, bevor etwas abgeschaltet wird, und prüfe, wer die alte Version noch nutzt, bevor ich sie deaktiviere.

Kümmern Sie sich darum, sobald es live ist

Eine Verbindung, die auf dem Laptop eines Entwicklers funktioniert, ist noch nicht fertig. Im realen Einsatz muss sie außerdem:

  • prüfen, wer anfragt und was diese Person sehen darf
  • begrenzen, wie viel ein einzelner Aufrufer senden kann, damit ein fehlerhaftes System es nicht überlasten kann
  • Informationen während der Übertragung verschlüsselt halten
  • überwacht werden, damit Verlangsamungen und Fehler frühzeitig erkannt werden
  • klare Beispiele enthalten, damit die Leute, die sich damit verbinden, es beim ersten Mal richtig machen

Der Test für eine gute Verbindung ist einfach: Die Systeme, die sie nutzen, können sich darauf verlassen, und die Leute, die sie betreuen, können verstehen, was sie tut.

Kurz gesagt

Eine zuverlässige Verbindung macht es einfach, das Richtige zu tun, und macht Probleme leicht verständlich. Klare Vereinbarungen, sicherer Umgang mit Wiederholungen, sorgfältige Änderungen und gute Überwachung sind keine Extras, die am Ende hinzugefügt werden. Sie sind Teil einer ordnungsgemäßen Umsetzung.

← Alle EinblickeSprechen Sie mit mir über Ihr System