Orders · Capability

Orders API — Orders

Orders API — Orders. 6 operations. Lead operation: Retrieves Orders. Self-contained Naftiko capability covering one Orders Api business surface.

Run with Naftiko Orders ApiOrders

What You Can Do

GET
Getorders — Retrieves Orders
/v1/orders
POST
Createorder — Orders Create Order
/v1/orders
GET
Getorder — Orders Retrieve Order
/v1/orders/{orderid}
PUT
Updateorder — Orders Update Order
/v1/orders/{orderid}
DELETE
Deleteorder — Orders Delete Order
/v1/orders/{orderid}
PUT
Sendorder — Orders Cancel Order
/v1/orders/{orderid}/cancle

MCP Tools

retrieves-orders

Retrieves Orders

read-only idempotent
orders-create-order

Orders Create Order

orders-retrieve-order

Orders Retrieve Order

read-only idempotent
orders-update-order

Orders Update Order

idempotent
orders-delete-order

Orders Delete Order

idempotent
orders-cancel-order

Orders Cancel Order

idempotent

Capability Spec

orders-orders.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: Orders API — Orders
  description: 'Orders API — Orders. 6 operations. Lead operation: Retrieves Orders. Self-contained Naftiko capability covering
    one Orders Api business surface.'
  tags:
  - Orders Api
  - Orders
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ORDERS_API_API_KEY: ORDERS_API_API_KEY
capability:
  consumes:
  - type: http
    namespace: orders-orders
    baseUri: https://api.example.com
    description: Orders API — Orders business capability. Self-contained, no shared references.
    resources:
    - name: orders
      path: /orders
      operations:
      - name: getorders
        method: GET
        description: Retrieves Orders
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createorder
        method: POST
        description: Orders Create Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: orders-orderId
      path: /orders/{orderId}
      operations:
      - name: getorder
        method: GET
        description: Orders Retrieve Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateorder
        method: PUT
        description: Orders Update Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteorder
        method: DELETE
        description: Orders Delete Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orders-orderId-cancle
      path: /orders/{orderId}/cancle
      operations:
      - name: sendorder
        method: PUT
        description: Orders Cancel Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: apikey
      key: api-key
      value: '{{env.ORDERS_API_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: orders-orders-rest
    port: 8080
    description: REST adapter for Orders API — Orders. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/orders
      name: orders
      description: REST surface for orders.
      operations:
      - method: GET
        name: getorders
        description: Retrieves Orders
        call: orders-orders.getorders
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createorder
        description: Orders Create Order
        call: orders-orders.createorder
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/orders/{orderid}
      name: orders-orderid
      description: REST surface for orders-orderId.
      operations:
      - method: GET
        name: getorder
        description: Orders Retrieve Order
        call: orders-orders.getorder
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateorder
        description: Orders Update Order
        call: orders-orders.updateorder
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteorder
        description: Orders Delete Order
        call: orders-orders.deleteorder
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/orders/{orderid}/cancle
      name: orders-orderid-cancle
      description: REST surface for orders-orderId-cancle.
      operations:
      - method: PUT
        name: sendorder
        description: Orders Cancel Order
        call: orders-orders.sendorder
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: orders-orders-mcp
    port: 9090
    transport: http
    description: MCP adapter for Orders API — Orders. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: retrieves-orders
      description: Retrieves Orders
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: orders-orders.getorders
      outputParameters:
      - type: object
        mapping: $.
    - name: orders-create-order
      description: Orders Create Order
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: orders-orders.createorder
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: orders-retrieve-order
      description: Orders Retrieve Order
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: orders-orders.getorder
      outputParameters:
      - type: object
        mapping: $.
    - name: orders-update-order
      description: Orders Update Order
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: orders-orders.updateorder
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: orders-delete-order
      description: Orders Delete Order
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: orders-orders.deleteorder
      outputParameters:
      - type: object
        mapping: $.
    - name: orders-cancel-order
      description: Orders Cancel Order
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: orders-orders.sendorder
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.