REST API Crash Course

Les 1 • REST-architectuurstijl

Behandelt de zes REST-beperkingen zoals gedefinieerd door Fielding en hoe ze API-ontwerp vormgeven. Koppelt architectuurprincipes aan praktische ontwerpbeslissingen.

Les 2 • HTTP-protocolgrondbeginselen

Legt HTTP uit als de transportlaag voor REST-API's, met behandelingen van verzoeken, antwoorden en headers. Biedt de protocolkennis die nodig is voor alle volgende hoofdstukken.

Les 3 • REST versus andere API-stijlen

Vergelijkt REST met SOAP, GraphQL en gRPC op basis van belangrijke dimensies. Helpt cursisten de juiste stijl te kiezen voor een bepaald gebruiksgeval.

Les 1 • Kern-HTTP-methoden

Behandelt GET, POST, PUT, PATCH en DELETE met hun beoogde semantiek en veilige/idempotente eigenschappen. Vormt de actiewoordenschat voor elk REST-endpoint.

Les 2 • Idempotentie en veiligheid

Definieert idempotentie en veiligheid als methode-eigenschappen die van invloed zijn op herhaallogica en caching. Koppelt deze eigenschappen aan betrouwbaar API-gedrag.

Les 3 • HTTP-statuscodeklassen

Legt de vijf statuscodeklassen (1xx–5xx) uit en hun betekenis in REST-antwoorden. Maakt nauwkeurige interpretatie van elk API-antwoord mogelijk.

Les 1 • Basisprincipes van resource-modellering

Leert hoe je resources kunt identificeren op basis van domeinentiteiten en ze kunt weergeven als zelfstandige naamwoorden in URL's. Ankert endpoint-ontwerp in een resource-eerste denkwijze.

Les 2 • URL-structuur en hiërarchie

Behandelt padsegmenten, geneste resources en queryparameters om relaties en filters uit te drukken. Produceert URL's die leesbaar en logisch gestructureerd zijn.

Les 3 • Beoordelingsproces voor endpoint-ontwerp

Introduceert een gestructureerde checklist voor het evalueren van endpoint-ontwerpen vóór implementatie. Koppelt ontwerpkwaliteit aan de downstream-ontwikkelaarservaring.

Les 4 • Naamgevingsconventies en standaarden

Stelt consistente conventies vast voor casing, scheidingstekens en versionering voor endpointnamen. Zorgt ervoor dat API's voorspelbaar zijn over teams en projecten heen.

Les 1 • Ontwerp van antwoordlichaam

Behandelt enveloppatronen, resource-representatie en foutantwoordstructuren. Zorgt dat consumenten consistente, bruikbare gegevens ontvangen.

Les 2 • Contentonderhandeling

Legt Accept- en Content-Type-headers uit voor formaatonderhandeling tussen client en server. Maakt het mogelijk dat API's meerdere formaten ondersteunen zonder consumenten te breken.

Les 3 • JSON als standaardformaat

Behandelt JSON-syntaxis, gegevenstypen en serialisatieregels als het dominante REST-payloadformaat. Biedt de gegevensformaatbasis voor al het payload-ontwerpwerk.

Les 1 • OAuth 2.0-flows

Legt de vier OAuth 2.0-granttypes uit en wanneer je ze toepast. Stelt cursisten in staat om gedelegeerde autorisatie te implementeren voor gebruikersgerichte API's.

Les 2 • Basisprincipes van API-beveiliging

Introduceert authenticatie versus autorisatie en veelvoorkomende dreigingsvectoren die gericht zijn op API's. Stelt de beveiligingsmentaliteit in die vereist is voor alle volgende implementatieonderwerpen.

Les 3 • Op rollen gebaseerd toegangsbeheer

Past autorisatieregels toe op endpoints met behulp van rollen en scopes. Zorgt dat API's toegang met het minste privilege afdwingen op resourceniveau.

Les 4 • API-sleutelauthenticatie

Behandelt API-sleutelgeneratie, verzending via headers of queryparameters, en rotatiestrategieën. Biedt een eenvoudig authenticatiemechanisme geschikt voor server-tot-server-scenario's.

Les 1 • Offset- en limietpaginering

Behandelt het offset-limietpatroon, de queryparameterconventies en de beperkingen op schaal. Biedt de meest gebruikte basislijn voor paginering.

Les 2 • Waarom paginering belangrijk is

Legt de prestatie- en bruikbaarheidsproblemen uit die worden veroorzaakt door onbegrensde verzamelingsantwoorden. Onderbouwt de noodzaak van paginering voordat implementatiestrategieën worden geïntroduceerd.

Les 3 • Cursor-gebaseerde paginering

Introduceert cursor-paginering als een stabiel, performant alternatief voor offset-paginering. Behandelt realtime gegevens- en grote datasetscenario's.

Les 4 • Sorteren en veldselectie

Leert sorteerparameterconventies en schaarse veldsetpatronen om de payloadgrootte te verkleinen. Completeert de toolkit voor gegevensophaling voor efficiënt API-gebruik.

Les 1 • Ontwerp van foutantwoord

Stelt een standaard foutantwoordschema vast met code-, bericht- en detailvelden. Consistente foutvormen verkorten de debuggingtijd voor consumenten.

Les 2 • Validatiefouten retourneren

Leert hoe je meerdere validatiefouten kunt aggregeren en retourneren in één antwoord. Verbetert de ontwikkelaarservaring door alle problemen tegelijk zichtbaar te maken.

Les 3 • Invoervalidatiestrategieën

Behandelt server-side validatie van aanvraaglichamen, padparameters en queryparameters. Voorkomt dat ongeldige gegevens de bedrijfslogica of database bereiken.

Les 1 • Waarom API's versionering nodig hebben

Legt brekende versus niet-brekende wijzigingen uit en de impact op de consument van ongeversioneerde evolutie. Bepaalt de businesscase voor een versioneringsstrategie.

Les 2 • OpenAPI-specificatie

Introduceert de OpenAPI-specificatie als de standaard voor het beschrijven van REST-API's in een machineleesbaar formaat. Koppelt spec-first ontwerp aan documentatie en codegeneratie.

Les 3 • Versioneringsstrategieën

Vergelijkt URL-pad-, queryparameter- en header-gebaseerde versionering met afwegingen voor elk. Maakt een weloverwogen keuze mogelijk van een versioneringsaanpak voor elk project.

Les 4 • Versies onderhouden en afschaffen

Biedt een proces voor het communiceren van afschaffingen, het instellen van vervaldatums en het uitschakelen van oude versies. Beschermt consumenten terwijl API-evolutie mogelijk wordt gemaakt.