Moderne Unternehmenssysteme stehen und fallen mit stabilen, klar dokumentierten APIs.

In diesem Kurs lernst du daher, REST-APIs nach bewährten Best Practices zu designen:

Von sauberer Ressourcenmodellierung über konsistente Fehlerformate bis zu Versionierung, Dokumentation mit OpenAPI und praxistauglichen Testing-Strategien.

Du bekommst zudem eine fundierte Einordnung, wann GraphQL, gRPC oder eventbasierte APIs mit AsyncAPI die bessere Wahl sind.

Typische Herausforderungen, die du nach dem Kurs souverän löst:

❓Wie schaffen wir einheitliche Regeln für Naming, Pagination und Filter?
❓Wie vermeiden wir Breaking Changes und setzen Versionierung sinnvoll ein?
❓Wie wird OpenAPI zu einem echten Contract statt Doku-Deko?
❓Wie testen wir APIs effizient (Contract, Integration, E2E) und reduzieren Defects?

Dein Vorteil:

✔️ Souveränes Verständnis für REST-Prinzipien und API-Design-Entscheidungen
✔️ Konsistente Ressourcen, Endpunkte und Response-Formate für skalierbare Schnittstellen
✔️ Sicherheit im Umgang mit HTTP-Standards und OpenAPI
✔️ Klarer Überblick über GraphQL, gRPC und AsyncAPI inkl. typischer Use Cases
✔️ Patterns, Checklisten und Beispiele, die du direkt im Projekt anwenden kannst
✔️ Solide Basis für moderne API-Testing- und Contract-Testing-Ansätze

Lerninhalte

REST-API Grundlagen

REST-Prinzipien, Ressourcenorientierung, Richardson Maturity Model
HTTP-Methoden, Statuscodes, Content Negotiation
Konsistenzregeln & Naming Conventions

Designpraktiken für hochwertige REST-APIs

URL-Design, Filter-/Sortier-/Paging-Strategien
Fehlerbehandlung (z. B. RFC 7807 Problem Details)
Idempotenz, Caching, Rate Limiting (Designsicht)
Datenmodelle und Response-Strukturen

API-Spezifikationen & Tooling

OpenAPI (Contract-First vs. Code-First), JSON Schema
Dokumentation

Alternative API-Stile (kompakter Überblick)

GraphQL: typische Anwendungsfälle und Grenzen
gRPC: interne, performanceorientierte APIs
AsyncAPI: Event-Driven Patterns und lose Kopplung

Versionierung & Lifecycle

Versionierungsstrategien (URL vs. Header, SemVer), Deprecation-Modelle
Rückwärtskompatibilität und Migrationsstrategien

API Testing

Unit/Integration/E2E, Testpyramide für APIs
HTTP-Testautomatisierung (z. B. REST Assured, Karate, Postman/Newman)
Contract Testing mit OpenAPI/JSON Schema, Consumer-Driven Contracts (z. B. Pact)

Übungen & Fallbeispiele

Review bestehender APIs, Design-Verbesserungen
Gemeinsame Modellierung eines konsistenten Ressourcenmodells
Ableitung eines API-Styleguides (praxisnah, teamtauglich)

Lernziele

Nach dem Kurs kannst du:

REST-APIs auf Basis bewährter Designprinzipien konzipieren
Ressourcen und Endpunkte konsistent modellieren (Naming, Filter, Sortierung, Paging)
OpenAPI-Spezifikationen erstellen, pflegen und validieren (Contract-First vs. Code-First)
Fehlerbehandlung, Versionierung und zentrale Sicherheitsmassnahmen sauber umsetzen
GraphQL, gRPC und AsyncAPI anhand von Vor- und Nachteilen sinnvoll einordnen

Zielgruppe

Dieses Training richtet sich an:

Software Engineers, Software-Architekten, Technical Leads
Fachpersonen mit API- oder Integrationsverantwortung
Product Owner mit technischem Fokus

Voraussetzungen:

Grundlagen der Softwareentwicklung, Erfahrung mit mindestens einer Programmiersprache (z. B. Java, C#, JavaScript/TypeScript)
Basiswissen zu HTTP, JSON und Request/Response Modellen
Umgang mit Git und typischen Entwicklungswerkzeugen

Weitere Details

Zertifizierung
Teilnehmer erhalten ein AKROS Academy Zertifikat.

Kursunterlagen
Wir von AKROS, lieben Nachhaltigkeit. Sobald wir Sie zu einem online Training angemeldet haben, werden die Dokumente zum Training elektronisch zur Verfügung gestellt. Während vor Ort Trainings, bekommen Sie die Unterlagen im Papierformat.

Keine passender Termin dabei?
Kein Problem! Melden Sie sich gerne per E-Mail bei academy@akros.ch und wir finden gemeinsam eine Lösung.

Spezialkonditionen

Early bird Rabatt
10% Rabatt - pro Training und Person - bis 30 Tage vor Kursbeginn.

Send your Team
10% Rabatt ab 3 Personen.
20% Rabatt ab 5 Personen.

In-house Trainings

Interne Firmenkurse
Ab 6 Teilnehmenden ist ein in-house Training immer die richtige Wahl. Mit unserem Angebot für interne Firmenkurse bieten wir Ihnen die Möglichkeit, mit uns gemeinsam ein Schulungskonzept zu erstellen, das passgenau auf Sie zugeschnitten ist – flexibel, exklusiv und selbstverständlich am Ort Ihrer Wahl. Mehr Informationen dazu finden Sie hier.

Wünschen Sie eine Offerte, haben Fragen oder Anregungen?
Senden Sie uns eine E-Mail an academy@akros.ch. Wir freuen uns auf Sie!

Warum AKROS?

Über 20 Trainer mit mehrjähriger Expertise und Hands-on-Erfahrung
Kurse in Ihrer Muttersprache
Schweizer Trainingsstandorte

Buchen

REST-API Design – strukturierte, konsistente Schnittstellen entwickeln