OpenAPI agent-readiness lint · Openapi Lint

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://agent402.tools/api/openapi-lint", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "spec": {
      "info": {
        "description": "An example API",
        "title": "Demo",
        "version": "1.0.0"
      },
      "openapi": "3.0.0",
      "paths": {
        "/users": {
          "get": {
            "parameters": [
              {
                "description": "Max results",
                "in": "query",
                "name": "limit",
                "schema": {
                  "example": 10,
                  "type": "integer"
                }
              }
            ],
            "responses": {
              "200": {
                "content": {
                  "application/json": {
                    "schema": {
                      "type": "array"
                    }
                  }
                },
                "description": "ok"
              },
              "400": {
                "description": "bad input"
              }
            },
            "summary": "List users",
            "tags": [
              "users"
            ]
          }
        }
      },
      "servers": [
        {
          "url": "https://api.example.com"
        }
      ]
    }
  }),
});
const data = await res.json();

curl -X POST \
  "https://agent402.tools/api/openapi-lint" \
  -H "Content-Type: application/json" \
  -d '{"spec":{"info":{"description":"An example API","title":"Demo","version":"1.0.0"},"openapi":"3.0.0","paths":{"/users":{"get":{"parameters":[{"description":"Max results","in":"query","name":"limit","schema":{"example":10,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"array"}}},"description":"ok"},"400":{"description":"bad input"}},"summary":"List users","tags":["users"]}}},"servers":[{"url":"https://api.example.com"}]}}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "counts": {
    "error": 0,
    "info": 0,
    "warning": 1
  },
  "ok": true,
  "score": 97,
  "violations": [
    {
      "location": "GET /users",
      "message": "Operation has no operationId - agents can't refer to this call by a stable name.",
      "rule": "operation-missing-operationid",
      "severity": "warning"
    }
  ]
}