BackendFull-Stack

OpenAPI / Swagger

Also written as OpenAPI, Swagger

A standard format for describing a REST API's endpoints, inputs, and outputs in a machine-readable file, which can then auto-generate documentation, client code, and testing tools.

Think of it like

Like a restaurant's official printed menu with every dish's ingredients listed, versus each customer having to ask the kitchen what's actually in each dish.

Junior or senior?

Junior sounds like

Wrote a spec once and let it go stale.

Senior sounds like

Can describe how their team kept the spec up to date as the real API changed.

Ask them

“How did your team keep the API spec from going stale as the actual API changed?”