APIs › Agent & Developer Utilities › OpenAPI Normalizer

OpenAPI Normalizer

Normalises an OpenAPI document — resolves internal $refs, sorts keys, fills operation IDs, unifies parameter style — and reports every change.

POST /v1/developer/openapi-normalize $0.02 per call

Specification

Endpoint

POST /v1/developer/openapi-normalize

Price

$0.02 per call · tier advanced_analysis

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · scheme exact

Data source

Deterministic local computation on caller-supplied input

Timeout

15 seconds

Max request

2 MB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/developer/openapi-normalize" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "document": {
    "info": {
      "title": "Demo",
      "version": "1.0.0"
    },
    "openapi": "3.0.3",
    "paths": {
      "/items": {
        "get": {
          "operationId": "get_items",
          "responses": {
            "200": {
              "description": "ok"
            }
          }
        }
      }
    }
  },
  "changes": [
    "generated operationId 'get_items' for GET /items",
    "sorted paths and object keys for stable diffs"
  ],
  "change_count": 2
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints