Saudi Arabian Services Company for Automotive and Equipment · API Governance Rules
Saudi Arabian Services Company for Automotive and Equipment API Rules
Spectral linting rules defining API design standards and conventions for Saudi Arabian Services Company for Automotive and Equipment.
29 Rules
error 22
warn 6
info 1
Rules by declared severity: the level each rule assigns to a violation. These are not lint results.
Generated by API Evangelist
Written by API Evangelist tooling for Saudi Arabian Services Company for Automotive and Equipment's APIs. It is a starting point, not a ruleset Saudi Arabian Services Company for Automotive and Equipment publishes or enforces.
Rule Categories
info
mediatype
operation
parameter
path
property
requestbody
response
schema
write
Rules
error
operation-has-tags
Every operation is tagged (measured: 100% of this contract)
$.paths[*][get,post,put,patch,delete]
error
operation-has-success-response
Every operation declares a 2xx response (measured: 100% of this contract)
$.paths[*][get,post,put,patch,delete].responses
error
path-no-trailing-slash
Paths carry no trailing slash (measured: 100% of this contract)
$.paths[*]~
error
path-params-in-braces
Path parameters use {braces}, not :colon (measured: 100% of this contract)
$.paths[*]~
warn
write-declares-request-body
POST and PUT declare a request body (measured: 99% of this contract)
$.paths[*][post,put]
error
response-media-type
Responses are served as text/plain (measured: 100% of this contract)
$.paths[*][get,post,put,patch,delete].responses[*].content
error
property-name-casing-camel
Schema property names are camel case (measured: 100% of this contract)
$.components.schemas[*].properties[*]~
error
info-title-present
Info declares title (measured: 100% of this contract)
$.info
error
info-version-present
Info declares version (measured: 100% of this contract)
$.info
error
info-version-semver
info.version is numeric (measured: 100% of this contract)
$.info.version
error
operation-tags-present
Operation declares tags (measured: 100% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace]
error
operation-parameters-present
Operation declares parameters (measured: 100% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace]
error
operation-responses-present
Operation declares responses (measured: 100% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace]
error
parameter-name-present
Parameter declares name (measured: 100% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace].parameters[*]
warn
parameter-name-casing-pascal
Parameter.name is pascal case (measured: 94% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace].parameters[*].name
error
parameter-in-present
Parameter declares in (measured: 100% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace].parameters[*]
warn
parameter-in-values
Parameter.in is one of header, path (measured: 99% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace].parameters[*].in
info
parameter-description-present
Parameter declares description (measured: 86% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace].parameters[*]
error
parameter-description-min-length
Parameter.description runs at least 12 characters (measured: 100% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace].parameters[*].description
error
parameter-schema-present
Parameter declares schema (measured: 100% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace].parameters[*]
error
requestbody-content-present
RequestBody declares content (measured: 100% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace].requestBody
error
mediatype-schema-present
MediaType declares schema (measured: 100% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace].responses[*].content[*]
error
response-description-present
Response declares description (measured: 100% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace].responses[*]
error
response-description-min-length
Response.description runs at least 7 characters (measured: 100% of this contract)
$.paths[*][get,put,post,delete,patch,options,head,trace].responses[*].description
error
schema-type-present
Schema declares type (measured: 100% of this contract)
$.components.schemas[*]
warn
schema-type-values
Schema.type is one of object (measured: 95% of this contract)
$.components.schemas[*].type
error
schema-format-values
Schema.format is one of int32 (measured: 100% of this contract)
$.components.schemas[*].format
warn
schema-properties-present
Schema declares properties (measured: 95% of this contract)
$.components.schemas[*]
warn
schema-additionalproperties-present
Schema declares additionalProperties (measured: 95% of this contract)
$.components.schemas[*]
Spectral Ruleset
Work with this as data
Every ruleset here is available over the APIs.io API and to AI agents over MCP.