OpenAPI Response Validator

Store Positioning

Store title: OpenAPI Response Validator

Short description: Validate live or supplied API responses against an OpenAPI operation’s expected response schema and return endpoint-level pass/fail evidence.

SEO title: OpenAPI Response Validator — API, schema, and developer QA

SEO description: Validate live or supplied API responses against an OpenAPI operation’s expected response schema and return endpoint-level pass/fail evidence. Use it to catch contract drift, schema mistakes, unsafe endpoint assumptions, and developer-tool quality issues before release.

Categories: SEO_TOOLS, DEVELOPER_TOOLS, ECOMMERCE

Keywords: openapi, response, validator, schema, api testing, api/developer qa

Pay-Per-Event Pricing

This actor uses pay-per-event pricing. Event prices include Apify platform usage; users are not expected to pay a separate platform-usage pass-through charge for the configured pricing model.

• Tier: A1 — API/developer QA
• Primary event: schema-validated at $0.00650 base
• Default max charge: $10.00
• Store discounts: FREE/BRONZE base, SILVER discounted, GOLD deepest approved discount

Event set:

• actor-start: base $0.00500, GOLD $0.00400. Openapi Response Validator: charged when actor start is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• schema-validated: base $0.00650, GOLD $0.00520. Openapi Response Validator: charged when schema validated is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• contract-rule-checked: base $0.00390, GOLD $0.00312. Openapi Response Validator: charged when contract rule checked is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• report-generated: base $0.05000, GOLD $0.04000. Openapi Response Validator: charged when report generated is completed. The price includes Apify platform usage; no separate usage pass-through is intended.

The actor accepts actor-start before work, accepts the primary event before each dataset row, and accepts report-generated before writing report files. If maxChargeUsd or the live PPE limit blocks a charge, the corresponding row or report is not written.

Public Task Concepts

• Validate OpenAPI Response records from a capped sample
• Find invalid OpenAPI Response values before delivery
• Check OpenAPI Response coverage against expected rules
• Prioritize OpenAPI Response validation failures by severity
• Export OpenAPI Response pass-fail rows with evidence Validate response samples against OpenAPI operation/status schemas.

What It Does

Parses OpenAPI 3.x JSON, resolves local $ref schemas, and validates required fields, types, enums, nullable values, arrays, and objects.

Inputs

This actor exposes these input fields in .actor/input_schema.json:

• openapiSpecUrl
• openapiSpecJson
• operationIds
• responseSamples
• baseUrl
• headers
• allowedMethods
• maxOperations
• timeoutMs
• validateExamplesOnly
• skipUnsafeMethods
• maxChargeUsd

The exact default fetches the public Swagger Petstore OpenAPI document and validates a bounded supplied inventory response against the documented schema. This keeps the automated first run deterministic while exercising the production validation path.

Outputs

Dataset rows contain:

• operationId
• method
• path
• statusCode
• schemaFound
• responseValid
• errorPath
• errorKeyword
• expectedType
• actualValue
• message
• recommendation

Sample outputs in examples/output.sample.json and output.sample.json were generated from examples/input.tiny.json through actor logic.

Reports

After the report-generated charge is accepted, the actor writes its Markdown, JSON, or CSV reports to the key-value store. A rejected report charge leaves those files unwritten.

Public Task Concepts

• Validate OpenAPI Response Validator before release
• Run a bounded OpenAPI Response Validator QA check
• Generate developer QA evidence for OpenAPI Response Validator

Safe use

Use small capped runs first. Network paths are bounded; review output quality and costs before increasing limits.