Kapitel 4. Bewährte Methoden für die Gestaltung
Diese Arbeit wurde mithilfe von KI übersetzt. Wir freuen uns über dein Feedback und deine Kommentare: translation-feedback@oreilly.com
In den vorangegangenen Kapiteln haben wir einen Überblick über verschiedene Ansätze für die Übertragung von Daten über deine Web-API gegeben. Jetzt, wo du mit der Transportlandschaft vertraut bist und weißt, wie du zwischen verschiedenen Mustern und Frameworks wählen kannst, wollen wir dir einige bewährte Methoden an die Hand geben, damit deine Entwickler das Beste aus deiner API herausholen können.
Entwerfen für reale Anwendungsfälle
Bei der Entwicklung einer API ist es am besten, Entscheidungen zu treffen, die auf konkreten, realen Anwendungsfällen beruhen. Gehen wir etwas näher auf diese Idee ein. Denke an die Entwickler, die deine API nutzen. Welche Aufgaben sollen sie mit deiner API erledigen können? Welche Arten von Apps sollten die Entwickler erstellen können? Für manche Unternehmen ist das so einfach zu beantworten wie "Entwickler sollten in der Lage sein, die Kreditkarten ihrer Kunden zu belasten". Für andere Unternehmen kann die Antwort offener ausfallen: "Entwickler sollten in der Lage sein, eine ganze Reihe von interaktiven Anwendungen in Verbraucherqualität zu erstellen.
Nachdem du deine Anwendungsfälle definiert hast, musst du sicherstellen, dass die Entwickler die Dinge, die sie tun sollen, auch tatsächlich mit deiner API tun können.
Häufig werden APIs auf der Grundlage der internen ...