AppyWay Explorer API — Parking

naftiko: 1.0.0-alpha2
info:
  label: AppyWay Explorer API — Parking
  description: 'AppyWay Explorer API — Parking. 11 operations. Lead operation: AppyWay Fetch event dates by id. Self-contained
    Naftiko capability covering one Appyway business surface.'
  tags:
  - Appyway
  - Parking
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    APPYWAY_API_KEY: APPYWAY_API_KEY
capability:
  consumes:
  - type: http
    namespace: explorer-parking
    baseUri: https://api.appyway.com/v1/explorer
    description: AppyWay Explorer API — Parking business capability. Self-contained, no shared references.
    resources:
    - name: fetchEventDatesById
      path: /fetchEventDatesById
      operations:
      - name: postfetcheventdatesbyid
        method: POST
        description: AppyWay Fetch event dates by id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: fetchOperatingHoursById
      path: /fetchOperatingHoursById
      operations:
      - name: postfetchoperatinghoursbyid
        method: POST
        description: AppyWay Fetch operating hours by id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: fetchOperatingHoursByIds
      path: /fetchOperatingHoursByIds
      operations:
      - name: postfetchoperatinghoursbyids
        method: POST
        description: AppyWay Fetch operating hours by ids
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: fetchParkingEntityById
      path: /fetchParkingEntityById
      operations:
      - name: postfetchparkingentitybyid
        method: POST
        description: AppyWay Fetch a parking Entity by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: fetchParkingQuoteById
      path: /fetchParkingQuoteById
      operations:
      - name: postfetchparkingquotebyid
        method: POST
        description: AppyWay Fetch a parking quote by id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: fetchParkingQuotesByIds
      path: /fetchParkingQuotesByIds
      operations:
      - name: postfetchparkingquotesbyids
        method: POST
        description: AppyWay Fetch parking quotes by ids
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: fetchPaymentProvidersByParkingEntityId
      path: /fetchPaymentProvidersByParkingEntityId
      operations:
      - name: postfetchpaymentprovidersbyparkingentityid
        method: POST
        description: AppyWay Fetch payment providers by parking entity ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: findParkingEntitiesByCentreAndViewportSize
      path: /findParkingEntitiesByCentreAndViewportSize
      operations:
      - name: postfindparkingentitiesbycentreandviewportsize
        method: POST
        description: AppyWay Find parking entities by centre and viewport size
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: findParkingEntitiesByViewport
      path: /findParkingEntitiesByViewport
      operations:
      - name: postfindparkingentitiesbyviewport
        method: POST
        description: AppyWay Find parking entities by viewport
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: findParkingQuotesByCentreAndViewportSize
      path: /findParkingQuotesByCentreAndViewportSize
      operations:
      - name: postfindparkingquotesbycentreandviewportsize
        method: POST
        description: AppyWay Find parking quotes by centre and viewport size
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: findParkingQuotesByViewport
      path: /findParkingQuotesByViewport
      operations:
      - name: postfindparkingquotesbyviewport
        method: POST
        description: AppyWay Find parking quotes by viewport
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: bearer
      token: '{{env.APPYWAY_API_KEY}}'
  exposes:
  - type: rest
    namespace: explorer-parking-rest
    port: 8080
    description: REST adapter for AppyWay Explorer API — Parking. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/fetcheventdatesbyid
      name: fetcheventdatesbyid
      description: REST surface for fetchEventDatesById.
      operations:
      - method: POST
        name: postfetcheventdatesbyid
        description: AppyWay Fetch event dates by id
        call: explorer-parking.postfetcheventdatesbyid
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/fetchoperatinghoursbyid
      name: fetchoperatinghoursbyid
      description: REST surface for fetchOperatingHoursById.
      operations:
      - method: POST
        name: postfetchoperatinghoursbyid
        description: AppyWay Fetch operating hours by id
        call: explorer-parking.postfetchoperatinghoursbyid
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/fetchoperatinghoursbyids
      name: fetchoperatinghoursbyids
      description: REST surface for fetchOperatingHoursByIds.
      operations:
      - method: POST
        name: postfetchoperatinghoursbyids
        description: AppyWay Fetch operating hours by ids
        call: explorer-parking.postfetchoperatinghoursbyids
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/fetchparkingentitybyid
      name: fetchparkingentitybyid
      description: REST surface for fetchParkingEntityById.
      operations:
      - method: POST
        name: postfetchparkingentitybyid
        description: AppyWay Fetch a parking Entity by ID
        call: explorer-parking.postfetchparkingentitybyid
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/fetchparkingquotebyid
      name: fetchparkingquotebyid
      description: REST surface for fetchParkingQuoteById.
      operations:
      - method: POST
        name: postfetchparkingquotebyid
        description: AppyWay Fetch a parking quote by id
        call: explorer-parking.postfetchparkingquotebyid
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/fetchparkingquotesbyids
      name: fetchparkingquotesbyids
      description: REST surface for fetchParkingQuotesByIds.
      operations:
      - method: POST
        name: postfetchparkingquotesbyids
        description: AppyWay Fetch parking quotes by ids
        call: explorer-parking.postfetchparkingquotesbyids
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/fetchpaymentprovidersbyparkingentityid
      name: fetchpaymentprovidersbyparkingentityid
      description: REST surface for fetchPaymentProvidersByParkingEntityId.
      operations:
      - method: POST
        name: postfetchpaymentprovidersbyparkingentityid
        description: AppyWay Fetch payment providers by parking entity ID
        call: explorer-parking.postfetchpaymentprovidersbyparkingentityid
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/findparkingentitiesbycentreandviewportsize
      name: findparkingentitiesbycentreandviewportsize
      description: REST surface for findParkingEntitiesByCentreAndViewportSize.
      operations:
      - method: POST
        name: postfindparkingentitiesbycentreandviewportsize
        description: AppyWay Find parking entities by centre and viewport size
        call: explorer-parking.postfindparkingentitiesbycentreandviewportsize
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/findparkingentitiesbyviewport
      name: findparkingentitiesbyviewport
      description: REST surface for findParkingEntitiesByViewport.
      operations:
      - method: POST
        name: postfindparkingentitiesbyviewport
        description: AppyWay Find parking entities by viewport
        call: explorer-parking.postfindparkingentitiesbyviewport
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/findparkingquotesbycentreandviewportsize
      name: findparkingquotesbycentreandviewportsize
      description: REST surface for findParkingQuotesByCentreAndViewportSize.
      operations:
      - method: POST
        name: postfindparkingquotesbycentreandviewportsize
        description: AppyWay Find parking quotes by centre and viewport size
        call: explorer-parking.postfindparkingquotesbycentreandviewportsize
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/findparkingquotesbyviewport
      name: findparkingquotesbyviewport
      description: REST surface for findParkingQuotesByViewport.
      operations:
      - method: POST
        name: postfindparkingquotesbyviewport
        description: AppyWay Find parking quotes by viewport
        call: explorer-parking.postfindparkingquotesbyviewport
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: explorer-parking-mcp
    port: 9090
    transport: http
    description: MCP adapter for AppyWay Explorer API — Parking. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: appyway-fetch-event-dates-id
      description: AppyWay Fetch event dates by id
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: explorer-parking.postfetcheventdatesbyid
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: appyway-fetch-operating-hours-id
      description: AppyWay Fetch operating hours by id
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: explorer-parking.postfetchoperatinghoursbyid
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: appyway-fetch-operating-hours-ids
      description: AppyWay Fetch operating hours by ids
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: explorer-parking.postfetchoperatinghoursbyids
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: appyway-fetch-parking-entity-id
      description: AppyWay Fetch a parking Entity by ID
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: explorer-parking.postfetchparkingentitybyid
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: appyway-fetch-parking-quote-id
      description: AppyWay Fetch a parking quote by id
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: explorer-parking.postfetchparkingquotebyid
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: appyway-fetch-parking-quotes-ids
      description: AppyWay Fetch parking quotes by ids
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: explorer-parking.postfetchparkingquotesbyids
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: appyway-fetch-payment-providers-parking
      description: AppyWay Fetch payment providers by parking entity ID
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: explorer-parking.postfetchpaymentprovidersbyparkingentityid
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: appyway-find-parking-entities-centre
      description: AppyWay Find parking entities by centre and viewport size
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: explorer-parking.postfindparkingentitiesbycentreandviewportsize
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: appyway-find-parking-entities-viewport
      description: AppyWay Find parking entities by viewport
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: explorer-parking.postfindparkingentitiesbyviewport
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: appyway-find-parking-quotes-centre
      description: AppyWay Find parking quotes by centre and viewport size
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: explorer-parking.postfindparkingquotesbycentreandviewportsize
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: appyway-find-parking-quotes-viewport
      description: AppyWay Find parking quotes by viewport
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: explorer-parking.postfindparkingquotesbyviewport
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.