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

Contact Information for APIs

Requiring that there is a contact included in the OpenAPI info.

Rules

OpenAPI Info Contact Error

Having a contact object associated with the technical contract ensures that anyone who comes across the API has someone to contact and get more information

OpenAPI Info Contact Info

Having a contact object associated with the technical contract ensures that anyone who comes across the API has someone to contact and get more information

OpenAPI Info Contact Name Error

Having a contact name associated with the technical contract ensures that anyone who comes across the API knows who to contact

OpenAPI Info Contact Name Info

Having a contact name associated with the technical contract ensures that anyone who comes across the API knows who to contact

OpenAPI Info Contact Email Error

Having a contact email address associated with the technical contract ensures that anyone who comes across the API has someone to email and get more information

OpenAPI Info Contact Email Info

Having a contact email address associated with the technical contract ensures that anyone who comes across the API has someone to email and get more information

OpenAPI Info Contact Url Error

Having a contact url associated with the technical contract ensures that anyone who comes across the API knows where to go to contact someone

OpenAPI Info Contact Url Info

Having a contact url associated with the technical contract ensures that anyone who comes across the API knows where to go to contact someone

Strategies

API Info and Metadata Is Complete and Accurate

All OpenAPI definitions must have complete info objects including title, description, version, contact information, license, and terms of service, providing both humans and machines with the contex...

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...