OpenAPI Request Body Have Examples Ref Error

Request body examples should be defined as $ref references to a centralized examples library so that they can be reused and maintained consistently.

Message: Request Body Examples SHOULD Use $ref References

Policies

Requiring that all operational request body examples meets the policy standards.

#OpenAPI #RequestBodies #Default

6 tools reach this content

find_building_blocksBrowse every rules entry — call it with type="rules".
get_building_blockOne rules entry in full; add include=content for the body (Pro).
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.

curl for this page

This rule

curl "https://api.apievangelist.com/v1/rules/openapi-request-body-have-examples-ref-error"

Full body (Pro)

curl "https://api.apievangelist.com/v1/rules/openapi-request-body-have-examples-ref-error?include=content" \
  -H "x-api-key: $AE_KEY"

Related across the network

curl "https://api.apievangelist.com/v1/rules/openapi-request-body-have-examples-ref-error/related"

All rules

curl "https://api.apievangelist.com/v1/rules?limit=25"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.