NASCAR Feed API — Inspection

naftiko: 1.0.0-alpha2
info:
  label: NASCAR Feed API — Inspection
  description: 'NASCAR Feed API — Inspection. 5 operations. Lead operation: AIM inspection system data. Self-contained Naftiko
    capability covering one Nascar business surface.'
  tags:
  - Nascar
  - Inspection
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    NASCAR_API_KEY: NASCAR_API_KEY
capability:
  consumes:
  - type: http
    namespace: nascar-inspection
    baseUri: https://feed.nascar.com
    description: NASCAR Feed API — Inspection business capability. Self-contained, no shared references.
    resources:
    - name: api-Inspection-aim-id
      path: /api/Inspection/aim/{id}
      operations:
      - name: getinspectionaim
        method: GET
        description: AIM inspection system data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
    - name: api-Inspection-devicenumbers
      path: /api/Inspection/devicenumbers
      operations:
      - name: getinspectiondevicenumbers
        method: GET
        description: Device number mapping
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-Inspection-idr-idrnumber
      path: /api/Inspection/idr/{idrnumber}
      operations:
      - name: getinspectionidr
        method: GET
        description: Entry IDR lookup
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: idrnumber
          in: path
          type: string
          required: true
    - name: api-Inspection-incidentwebhook
      path: /api/Inspection/incidentwebhook
      operations:
      - name: postinspectionincidentwebhook
        method: POST
        description: Safety incident reporting webhook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-Inspection-submission-technique
      path: /api/Inspection/submission/technique
      operations:
      - name: getinspectiontechniquesubmissions
        method: GET
        description: Technique submissions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: nascar-inspection-rest
    port: 8080
    description: REST adapter for NASCAR Feed API — Inspection. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/api/inspection/aim/{id}
      name: api-inspection-aim-id
      description: REST surface for api-Inspection-aim-id.
      operations:
      - method: GET
        name: getinspectionaim
        description: AIM inspection system data
        call: nascar-inspection.getinspectionaim
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/inspection/devicenumbers
      name: api-inspection-devicenumbers
      description: REST surface for api-Inspection-devicenumbers.
      operations:
      - method: GET
        name: getinspectiondevicenumbers
        description: Device number mapping
        call: nascar-inspection.getinspectiondevicenumbers
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/inspection/idr/{idrnumber}
      name: api-inspection-idr-idrnumber
      description: REST surface for api-Inspection-idr-idrnumber.
      operations:
      - method: GET
        name: getinspectionidr
        description: Entry IDR lookup
        call: nascar-inspection.getinspectionidr
        with:
          idrnumber: rest.idrnumber
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/inspection/incidentwebhook
      name: api-inspection-incidentwebhook
      description: REST surface for api-Inspection-incidentwebhook.
      operations:
      - method: POST
        name: postinspectionincidentwebhook
        description: Safety incident reporting webhook
        call: nascar-inspection.postinspectionincidentwebhook
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/inspection/submission/technique
      name: api-inspection-submission-technique
      description: REST surface for api-Inspection-submission-technique.
      operations:
      - method: GET
        name: getinspectiontechniquesubmissions
        description: Technique submissions
        call: nascar-inspection.getinspectiontechniquesubmissions
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: nascar-inspection-mcp
    port: 9090
    transport: http
    description: MCP adapter for NASCAR Feed API — Inspection. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: aim-inspection-system-data
      description: AIM inspection system data
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: nascar-inspection.getinspectionaim
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: device-number-mapping
      description: Device number mapping
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: nascar-inspection.getinspectiondevicenumbers
      outputParameters:
      - type: object
        mapping: $.
    - name: entry-idr-lookup
      description: Entry IDR lookup
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: nascar-inspection.getinspectionidr
      with:
        idrnumber: tools.idrnumber
      outputParameters:
      - type: object
        mapping: $.
    - name: safety-incident-reporting-webhook
      description: Safety incident reporting webhook
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: nascar-inspection.postinspectionincidentwebhook
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: technique-submissions
      description: Technique submissions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: nascar-inspection.getinspectiontechniquesubmissions
      outputParameters:
      - type: object
        mapping: $.