Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Schema Type

Requiring that all schema type meets the policy standards.

Rules

OpenAPI Schema Type Error

Schema should have a type defined, being explicit about type of data a schema describes and can be used to validate, helping standardize the type of data being made available

OpenAPI Schema Type Info

Schema should have a type defined, being explicit about type of data a schema describes and can be used to validate, helping standardize the type of data being made available

Strategies

Data Should Be Well-Defined and Validated

The schema for data that is sent and received via API should always be well-defined, possess a well-known shape, and always be validated, ensuring that digital resources and capabilities are what t...

Lifecycle

design_services Design Design

Design is where the human experience of an API is won or lost. I work design-first, shaping the paths, schema, errors, and naming in the contract before development begins, so that consistency is b...