Design an Idiomatic REST + Webhooks API for a Logistics SaaS
Overview
What this challenge is about.
Design a REST + webhooks API guideline and OpenAPI 3.1 spec for a logistics SaaS, then earn a verifiable certificate.
The scenario
The SaaS (Series-B at EUR 40M raised, 4 major terminal customers in EU + Singapore) plans to onboard 25 customs-broker integrators in Q3 — a messy API would burn the integration team for years.
The Brief
What you'll do, and what you'll demonstrate.
Author an API design guideline, redesign 12 resources, and design a production-grade webhook subsystem for a logistics SaaS launching a public API.
Earning criteria — what you'll demonstrate
- Author an API guideline that survives the team's first 12 resources
- Design a webhook subsystem with at-least-once + idempotency
- Trade off URL versioning vs header versioning with evidence
- Self-critique a public API before integrators do
Program Fit
Where this fits in your program.
Sharpens the same skills your degree expects you to demonstrate.
Software Design and Design Patterns
Master · Software Engineering
Strong alignment
This challenge maps to Software Design and Design Patterns at the Master level. It sharpens the same practical skills your coursework expects — but in a real industry context with actual constraints and deliverables.
Skills
Skills you'll demonstrate.
Each one shows up on your verified credential.
- Api Design
Design RESTful and GraphQL APIs that are intuitive, consistent, and well-documented.
- Rest
Apply rest to solve real industry problems and demonstrate production-level capability.
- Openapi
Apply openapi to solve real industry problems and demonstrate production-level capability.
- Webhooks
Apply webhooks to solve real industry problems and demonstrate production-level capability.
- Idempotency
Apply idempotency to solve real industry problems and demonstrate production-level capability.
- Developer Experience
Apply developer experience to solve real industry problems and demonstrate production-level capability.
Careers
Career paths this challenge builds toward
Completing this challenge demonstrates skills that transfer directly to these roles: