eBay Catalog API — Product

naftiko: 1.0.0-alpha2
info:
  label: eBay Catalog API — Product
  description: 'eBay Catalog API — Product. 1 operations. Lead operation: Product. Self-contained Naftiko capability covering
    one Ebay business surface.'
  tags:
  - Ebay
  - Product
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    EBAY_API_KEY: EBAY_API_KEY
capability:
  consumes:
  - type: http
    namespace: catalog-product
    baseUri: https://api.ebay.com{basePath}
    description: eBay Catalog API — Product business capability. Self-contained, no shared references.
    resources:
    - name: product-epid
      path: /product/{epid}
      operations:
      - name: getproduct
        method: GET
        description: This method retrieves details of the catalog product identified by the eBay product identifier (ePID)
          specified in the request. These details include the product's title and description, aspects and their values, associated
          images, applicab
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: X-EBAY-C-MARKETPLACE-ID
          in: header
          type: string
          description: This method also uses the <code>X-EBAY-C-MARKETPLACE-ID</code> header to identify the seller's eBay
            marketplace. It is required for all <a href="/api-docs/comme
        - name: epid
          in: path
          type: string
          description: The eBay product identifier (ePID) of the product being requested. This value can be discovered by
            issuing the <b>search</b> method and examining the value of t
          required: true
    authentication:
      type: bearer
      token: '{{env.EBAY_API_KEY}}'
  exposes:
  - type: rest
    namespace: catalog-product-rest
    port: 8080
    description: REST adapter for eBay Catalog API — Product. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/product/{epid}
      name: product-epid
      description: REST surface for product-epid.
      operations:
      - method: GET
        name: getproduct
        description: This method retrieves details of the catalog product identified by the eBay product identifier (ePID)
          specified in the request. These details include the product's title and description, aspects and their values, associated
          images, applicab
        call: catalog-product.getproduct
        with:
          X-EBAY-C-MARKETPLACE-ID: rest.X-EBAY-C-MARKETPLACE-ID
          epid: rest.epid
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: catalog-product-mcp
    port: 9090
    transport: http
    description: MCP adapter for eBay Catalog API — Product. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: this-method-retrieves-details-catalog
      description: This method retrieves details of the catalog product identified by the eBay product identifier (ePID) specified
        in the request. These details include the product's title and description, aspects and their values, associated images,
        applicab
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: catalog-product.getproduct
      with:
        X-EBAY-C-MARKETPLACE-ID: tools.X-EBAY-C-MARKETPLACE-ID
        epid: tools.epid
      outputParameters:
      - type: object
        mapping: $.