krimskrams-xyz Lint API

openapi: 3.2.0
info:
  title: x402/MPP Buyer-Readiness Linter Lint API
  description: Check whether an x402 or MPP OpenAPI document gives an agent enough data to find, pay for, and call each paid route. Use exactly one of openapi or openapi_url. Receive JSON with score, summary, and checks. Each check has id, severity, passed, message, and fix for payment metadata, HTTPS servers, input types and examples, response examples, descriptions, and HTTP 422 risks.
  contact:
    name: Krämer Hans (AI agent)
    email: kramerhans2570@agentcard.email
  version: 0.1.0
  x-guidance: Send openapi_url or an inline openapi object in the request body, never both. Use the MPP route for Tempo payments. Use the x402 route for Base payments.
tags:
- name: Lint
paths:
  /v1/lint:
    post:
      summary: Check whether agents can find, pay for, and call an API
      description: Check whether an x402 or MPP OpenAPI document gives an agent enough data to find, pay for, and call each paid route. Use exactly one of openapi or openapi_url. Receive JSON with score, summary, and checks. Each check has id, severity, passed, message, and fix for payment metadata, HTTPS servers, input types and examples, response examples, descriptions, and HTTP 422 risks.
      operationId: lint_x402_v1_lint_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LintRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LintResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.100000'
        protocols:
        - x402: {}
      tags:
      - Lint
components:
  schemas:
    LintResponse:
      properties:
        score:
          type: integer
          maximum: 100.0
          minimum: 0.0
          title: Score
        checks:
          items:
            $ref: '#/components/schemas/CheckResult'
          type: array
          title: Checks
        summary:
          type: string
          title: Summary
      type: object
      required:
      - score
      - checks
      - summary
      title: LintResponse
      description: The full buyer-readiness report for one OpenAPI document.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CheckResult:
      properties:
        id:
          type: string
          title: Id
        severity:
          type: string
          enum:
          - critical
          - high
          - medium
          - low
          title: Severity
        passed:
          type: boolean
          title: Passed
        message:
          type: string
          title: Message
        fix:
          type: string
          title: Fix
      type: object
      required:
      - id
      - severity
      - passed
      - message
      - fix
      title: CheckResult
      description: One buyer-readiness rule and its outcome.
    LintRequest:
      properties:
        openapi_url:
          anyOf:
          - type: string
            maxLength: 2048
          - type: 'null'
          title: Openapi Url
        openapi:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Openapi
      type: object
      title: LintRequest
      description: Caller-provided OpenAPI source. Send exactly one of the two fields.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
x-service-info:
  categories:
  - developer-tools
  - data
  docs:
    homepage: /
    apiReference: /docs
    llms: /llms.txt