bunq API — Device Server

naftiko: 1.0.0-alpha2
info:
  label: bunq API — Device Server
  description: 'bunq API — Device Server. 3 operations. Lead operation: Device Server. Self-contained Naftiko capability covering
    one Bunq business surface.'
  tags:
  - Bunq
  - Device Server
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    BUNQ_API_KEY: BUNQ_API_KEY
capability:
  consumes:
  - type: http
    namespace: bunq-device-server
    baseUri: https://public-api.sandbox.bunq.com/{basePath}
    description: bunq API — Device Server business capability. Self-contained, no shared references.
    resources:
    - name: device-server
      path: /device-server
      operations:
      - name: createdeviceserver
        method: POST
        description: Create a new DeviceServer providing the installation token in the header and signing the request with
          the private part of the key you used to create the installation. The API Key that you are using will be bound to
          the IP address of the Dev
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: listalldeviceserver
        method: GET
        description: Get a collection of all the DeviceServers you have created.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: device-server-itemId
      path: /device-server/{itemId}
      operations:
      - name: readdeviceserver
        method: GET
        description: Get one of your DeviceServers.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: itemId
          in: path
          type: integer
          required: true
  exposes:
  - type: rest
    namespace: bunq-device-server-rest
    port: 8080
    description: REST adapter for bunq API — Device Server. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/device-server
      name: device-server
      description: REST surface for device-server.
      operations:
      - method: POST
        name: createdeviceserver
        description: Create a new DeviceServer providing the installation token in the header and signing the request with
          the private part of the key you used to create the installation. The API Key that you are using will be bound to
          the IP address of the Dev
        call: bunq-device-server.createdeviceserver
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: listalldeviceserver
        description: Get a collection of all the DeviceServers you have created.
        call: bunq-device-server.listalldeviceserver
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/device-server/{itemid}
      name: device-server-itemid
      description: REST surface for device-server-itemId.
      operations:
      - method: GET
        name: readdeviceserver
        description: Get one of your DeviceServers.
        call: bunq-device-server.readdeviceserver
        with:
          itemId: rest.itemId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: bunq-device-server-mcp
    port: 9090
    transport: http
    description: MCP adapter for bunq API — Device Server. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: create-new-deviceserver-providing-installation
      description: Create a new DeviceServer providing the installation token in the header and signing the request with the
        private part of the key you used to create the installation. The API Key that you are using will be bound to the IP
        address of the Dev
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: bunq-device-server.createdeviceserver
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-collection-all-deviceservers-you
      description: Get a collection of all the DeviceServers you have created.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: bunq-device-server.listalldeviceserver
      outputParameters:
      - type: object
        mapping: $.
    - name: get-one-your-deviceservers
      description: Get one of your DeviceServers.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: bunq-device-server.readdeviceserver
      with:
        itemId: tools.itemId
      outputParameters:
      - type: object
        mapping: $.