api-datamodelTurn backend endpoints into business APIs

Use Services to unify boundaries, request rules, and types so application code depends only on stable business capabilities.

Business API Modeling

Organize stable entry points such as userApi and orderApi by business module instead of scattering URLs and request details across pages.

Centralize paths, defaults, response transformation, loading states, messages, errors, and cancellation.

Generate types and business APIs that use the same model when an OpenAPI document is available.

text

Backend API
     ↓
  Service
     ↓
Business API
     ↓
Application Code

A Service defines the service boundary, while business APIs expose concrete capabilities:

await userApi.list({ page: 1 })
await orderApi.submit(data)

Application code no longer assembles URLs or repeatedly handles the same request rules.

Codegen supports API modeling and produces the same kind of business API:

text

OpenAPI → API Codegen → TypeScript Types + Business APIs

Start with the Introduction to understand the model, or go directly to API Codegen if you already have OpenAPI.