IKEA After Purchase Ordering API - Parts

naftiko: 1.0.0-alpha2
info:
  label: IKEA After Purchase Ordering API - Parts
  description: 'IKEA After Purchase Ordering API - Parts. 3 operation(s). Lead operation: IKEA Find Part by Id. Self-contained Naftiko capability covering one IKEA business surface (community / unofficial
    spec).'
  tags:
  - IKEA
  - Parts
  - Unofficial API
  - Opensource
  created: '2026-05-30'
  modified: '2026-05-30'
binds:
- namespace: env
  description: Environment-bound configuration (country, language, API tokens if any).
consumes:
- name: after-purchase-ordering
  description: Inlined consume block for the unofficial IKEA Parts surface.
  base:
    url: https://api.prod.apo.ingka.com
  auth:
    type: none
    description: Community IKEA storefront endpoints currently require no authentication. The DIRIGERA hub uses bearer tokens but is not covered by this capability.
  operations:
  - name: getPartById
    method: GET
    path: /part/{partId}
    summary: IKEA Find Part by Id
    description: Returns a single replacement part
  - name: searchParts
    method: GET
    path: /search/{partialPartId}
    summary: IKEA Find Parts
    description: Returns multiple parts matching the provided id
  - name: getProductParts
    method: GET
    path: /products
    summary: IKEA Find Parts for Product(s)
    description: Returns replacement parts information for one or more products
exposers:
  rest:
    name: after-purchase-ordering-parts-rest
    description: REST exposer for the Parts capability — passes through to the underlying IKEA endpoint.
    base:
      path: /parts
    resources:
    - path: /part/{partId}
      method: GET
      operation: getPartById
      summary: IKEA Find Part by Id
    - path: /search/{partialPartId}
      method: GET
      operation: searchParts
      summary: IKEA Find Parts
    - path: /products
      method: GET
      operation: getProductParts
      summary: IKEA Find Parts for Product(s)
  mcp:
    name: after-purchase-ordering-parts-mcp
    description: MCP exposer for the Parts capability — each operation is exposed as a verb-noun MCP tool.
    tools:
    - name: getPartById
      title: IKEA Find Part by Id
      description: Returns a single replacement part
      operation: getPartById
    - name: searchParts
      title: IKEA Find Parts
      description: Returns multiple parts matching the provided id
      operation: searchParts
    - name: getProductParts
      title: IKEA Find Parts for Product(s)
      description: Returns replacement parts information for one or more products
      operation: getProductParts