API Linting · Example Payload

Linting Rule Normalized Example

Every operation must have a unique operationId.

API LintingNamingOpenAPI

Linting Rule Normalized Example is an example object payload from API Linting, with 14 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

$schemaiddescriptionmessageseveritygiventhentargetformatsrecommendedtagssourceToolsourceUrldocumentationUrl

Example Payload

{
  "$schema": "https://api-evangelist.github.io/linting/json-schema/linting-rule-schema.json",
  "id": "operation-operationId-unique",
  "description": "Every operation must have a unique operationId.",
  "message": "Operation IDs must be globally unique across the document. Duplicate operationId at {{path}}.",
  "severity": "error",
  "given": ["$"],
  "then": [
    {
      "function": "oasOpIdUnique"
    }
  ],
  "target": "operations",
  "formats": ["oas2", "oas3_0", "oas3_1"],
  "recommended": true,
  "tags": [
    "API Linting",
    "Naming",
    "OpenAPI"
  ],
  "sourceTool": "spectral",
  "sourceUrl": "https://github.com/stoplightio/spectral/blob/develop/packages/rulesets/src/oas/index.ts",
  "documentationUrl": "https://docs.stoplight.io/docs/spectral/4dec24461f3af-open-api-rules#operation-operationid-unique"
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/linting-rule-normalized-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.