real projects · Cohort hybrid

Contract-First APIs with OpenAPI + Spring

Design YAML first, generate interfaces, and keep consumer-driven tests honest.

Duration
4 weeks · 46 mentor hours
Schedule
Mixed
Level
Intermediate
Price
13,200 THB (informational)

OpenAPI 3.1 · SpringDoc · Spring Cloud Contract

Cover for Contract-First APIs with OpenAPI + Spring

Description

Teams model a procurement API, generate Spring interfaces with openapi-generator, and align provider/consumer tests using Spring Cloud Contract without drifting schemas.

What arrives in your repo

  • OpenAPI lint rules in CI
  • Generator customization hooks
  • DTO mapping guardrails
  • Breaking change detection playbook
  • MockMvc vs WebTestClient guidance
  • Error payload consistency review
  • Peer review rubric for API reviews

Outcomes we expect you to evidence

  1. Publish versioned OpenAPI with changelog
  2. Wire consumer tests that fail on silent breaks
  3. Facilitate API review with evidence
Avatar for Benja Ruang

Responsible instructor

Benja Ruang

API guild lead for B2B marketplaces.

FAQ

Not covered — REST + JSON only.

Experience notes

“Contract-First APIs changelog template stopped our silent field renames.”
— Marcus , Tech lead
“OpenAPI lint stage noisy at first — mentors tuned rules with us live.”
— Anonymous reviewer