API

Eine gute Webarchitektur schafft klare Grenzen zwischen Komponenten und nutzt die Standards des Webs konsequent. Dazu gehören verständliche Ressourcenmodelle, klar definierte Schnittstellen und die passende Nutzung von HTTP-Methoden, Statuscodes und Caching. Das erleichtert nicht nur die Entwicklung, sondern sorgt auch dafür, dass Systeme langfristig wartbar und erweiterbar bleiben.

INNOQ unterstützt Teams bei der Konzeption und Weiterentwicklung solcher Architekturen: Softwarearchitektur und -entwicklung

REST eignet sich besonders, wenn Systeme über klar definierte Ressourcen miteinander interagieren und Schnittstellen über längere Zeit stabil und unabhängig weiterentwickelbar bleiben sollen.

Wer die zugrunde liegenden Prinzipien vertiefen möchte, findet sie auch in unserer iSAQB®-Schulung Web-native Softwarearchitektur.

HTTP bringt bereits viele Mechanismen mit, die für robuste APIs benötigt werden: Methoden, Statuscodes, Header, Content Negotiation und Caching. Werden diese Möglichkeiten konsequent genutzt, müssen Teams weniger eigene Konventionen entwickeln. APIs werden dadurch verständlicher, interoperabler und leichter in bestehende Infrastruktur integrierbar.

In der Schulung Web-native Softwarearchitektur vermitteln wir, wie sich diese Prinzipien in der Praxis einsetzen lassen.

Hinweise auf ungünstig geschnittene APIs sind eine hohe Kopplung zwischen Clients und Schnittstelle, Änderungen, die regelmäßig mehrere Endpunkte betreffen, sowie die direkte Abbildung interner Datenmodelle in der API. Auch eine große Zahl kleinteiliger Aufrufe oder spezifischer Sonderoperationen kann darauf hindeuten, dass Ressourcen und Verantwortlichkeiten nicht entlang fachlich sinnvoller Grenzen geschnitten sind.

Bei bestehenden Systemen hilft ein unabhängiges Software-Review, strukturelle Schwächen der API sichtbar zu machen und konkrete Verbesserungsmöglichkeiten abzuleiten. Mehr dazu: Software-Reviews

Ressourcengrenzen beeinflussen, welche Teile eines Systems unabhängig voneinander verändert werden können. Sind Verantwortlichkeiten unklar oder Schnittstellen zu eng an interne Implementierungen gekoppelt, breiten sich Änderungen schnell über mehrere Systeme aus. Gut gewählte Grenzen reduzieren diese Kopplung und erleichtern die unabhängige Weiterentwicklung.

INNOQ betrachtet dabei nicht nur einzelne APIs, sondern auch deren Einbettung in die gesamte Softwarearchitektur: Softwarearchitektur und -entwicklung

Security sollte bereits beim Entwurf der Architektur und der Schnittstellen berücksichtigt werden. Dazu gehören unter anderem Authentifizierung und Autorisierung, sichere Datenübertragung, ein bewusster Umgang mit Browser-Sicherheitsmechanismen sowie Schutz vor typischen Angriffen auf Webanwendungen und APIs.

INNOQ unterstützt bei der Analyse und Entwicklung sicherer Systeme: IT-Security

Für Entwickler bieten wir außerdem die Schulungen Web Security und OWASP Top 10 an.

Wir unterstützen Entwicklungsteams bei der Konzeption, Bewertung und Weiterentwicklung von Webarchitekturen und APIs. Dabei geht es nicht nur um einzelne Technologien, sondern um Fragen wie Ressourcengrenzen, Kopplung, Integrationsmuster, Security und langfristige Wartbarkeit. Je nach Ausgangslage arbeiten wir gemeinsam an der Architektur, führen Reviews durch oder vermitteln das notwendige Wissen direkt im Team.

Mehr dazu: Softwarearchitektur und -entwicklung, Software-Reviews und Web-native Softwarearchitektur.