https://thedotnetblog.com/de/tags/rest-api/Articles, tutorials and insights from the .NET community.Hugode@thedotnetblog (The .NET Blog)@thedotnetblogFri, 17 Jul 2026 00:00:00 +0000https://thedotnetblog.com/de/news/emiliano-montesdeoca/data-api-builder-custom-paths-domain-first/Fri, 17 Jul 2026 00:00:00 +0000Emiliano Montesdeocahttps://thedotnetblog.com/de/news/emiliano-montesdeoca/data-api-builder-custom-paths-domain-first/Zusammengesetzte REST-Pfade in DAB sind eine kleine Funktion mit großer architektonischer Wirkung für domänenorientiertes API-Design.<p>Originalquelle: <a href="https://devblogs.microsoft.com/azure-sql/data-api-builder-custom-rest-paths/">Compose your API surface with Data API builder custom paths</a></p> <p>Die neue Unterstützung für zusammengesetzte REST-Pfade in Data API Builder mag wie eine kleine Konfigurationsverbesserung aussehen, aber sie löst tatsächlich eine langjährige API-Design-Spannung: Datenbanktopologie, die in das öffentliche Endpunkt-Design durchsickert.</p> <p>Standard-Entity-basierte Routen sind großartig für schnelle Starts. Sie sind oft falsch für langfristige Produkt-APIs. Echte Systeme benötigen Routenstrukturen, die Geschäftskonzepten, Eigentumsgrenzen und Verbraucher-Denkmodellen entsprechen.</p> <p>Deshalb ist diese DAB-Änderung wichtig. Sie können den Komfort generierter APIs behalten, während Sie eine sauberere domänenorientierte Oberfläche präsentieren.</p> <p>Meine Meinung ist einfach: Wenn Ihre API-Pfadstruktur in der Produktion rohe Tabellennamen widerspiegelt, optimieren Sie normalerweise für Backend-Komfort auf Kosten der Client-Klarheit.</p> <p>Mit benutzerdefinierten Pfaden können Teams bessere Grenzen modellieren, wie Vertrieb, Abrechnung, Support oder partnerspezifische Oberflächen. Dies ersetzt keine ordnungsgemäße API-Governance, gibt DAB-Benutzern aber einen praktischen Weg, das Routen-Design an der Produktsprache auszurichten.</p> <p>Praktische Richtlinien für Teams, die diese Funktion einführen:</p> <p>Definieren Sie eine Namensrichtlinie, bevor Sie Pfade ad hoc hinzufügen. Inkonsistente Untersegmente werden zu langfristigem Chaos.</p> <p>Ordnen Sie Endpunkte begrenzten Kontexten zu, nicht Organigrammen. Teams ändern sich; Domänensemantik sollte stabil sein.</p> <p>Behandeln Sie die Pfadstruktur als Teil Ihrer Versionierungsstrategie und dokumentieren Sie breaking changes explizit.</p> <p>Validieren Sie das Autorisierungsverhalten entlang benutzerdefinierter Routenstrukturen, damit Routenklarheit mit Sicherheitsklarheit einhergeht.</p>