Flower Shop Network JSON API

naftiko: 1.0.0-alpha2
info:
  label: Flower Shop Network JSON API
  description: The Flower Shop Network (FSN) JSON API is a REST-style HTTPS interface that allows florist point-of-sale systems
    and partners to authenticate, look up products and florists, and exchange wire orders across the FSN florist network.
    All endpoints accept and return JSON and require an API token.
  tags:
  - Flower
  - Shop
  - Network
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: flower-shop-network
    baseUri: https://api.flowershopnetwork.com/api
    description: Flower Shop Network JSON API HTTP API.
    resources:
    - name: api-foreignsystem-apigetpostoken
      path: /API/ForeignSystem.apiGetPosToken
      operations:
      - name: post-api-foreignsystem-apigetpostoken
        method: POST
        description: Issue API token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-token-apicheck
      path: /API/Token.apiCheck
      operations:
      - name: post-api-token-apicheck
        method: POST
        description: Validate token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: myfsnproduct-apiloadproductdata
      path: /MyfsnProduct.apiLoadProductData
      operations:
      - name: post-myfsnproduct-apiloadproductdata
        method: POST
        description: Load product data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: relayutil-apisearchflorists
      path: /RelayUtil.apiSearchFlorists
      operations:
      - name: post-relayutil-apisearchflorists
        method: POST
        description: Search filling florists
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: relayorder-apigetorder
      path: /RelayOrder.apiGetOrder
      operations:
      - name: post-relayorder-apigetorder
        method: POST
        description: Retrieve order details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: relayorder-apireceiveorders
      path: /RelayOrder.apiReceiveOrders
      operations:
      - name: post-relayorder-apireceiveorders
        method: POST
        description: Receive incoming orders awaiting accept/refuse
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: relayorder-apiacceptorder
      path: /RelayOrder.apiAcceptOrder
      operations:
      - name: post-relayorder-apiacceptorder
        method: POST
        description: Accept an incoming order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: relayorder-apirefuseorder
      path: /RelayOrder.apiRefuseOrder
      operations:
      - name: post-relayorder-apirefuseorder
        method: POST
        description: Refuse an incoming order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: relayorder-apisendorder
      path: /RelayOrder.apiSendOrder
      operations:
      - name: post-relayorder-apisendorder
        method: POST
        description: Send a florist-to-florist order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: relayorder-apiconfirmdelivery
      path: /RelayOrder.apiConfirmDelivery
      operations:
      - name: post-relayorder-apiconfirmdelivery
        method: POST
        description: Confirm order delivery
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: relayorder-apigetdeliveryconfirmation
      path: /RelayOrder.apiGetDeliveryConfirmation
      operations:
      - name: post-relayorder-apigetdeliveryconfirmation
        method: POST
        description: Retrieve delivery confirmation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: flower-shop-network-rest
    description: REST adapter for Flower Shop Network JSON API.
    resources:
    - path: /API/ForeignSystem.apiGetPosToken
      name: post-api-foreignsystem-apigetpostoken
      operations:
      - method: POST
        name: post-api-foreignsystem-apigetpostoken
        description: Issue API token
        call: flower-shop-network.post-api-foreignsystem-apigetpostoken
        outputParameters:
        - type: object
          mapping: $.
    - path: /API/Token.apiCheck
      name: post-api-token-apicheck
      operations:
      - method: POST
        name: post-api-token-apicheck
        description: Validate token
        call: flower-shop-network.post-api-token-apicheck
        outputParameters:
        - type: object
          mapping: $.
    - path: /MyfsnProduct.apiLoadProductData
      name: post-myfsnproduct-apiloadproductdata
      operations:
      - method: POST
        name: post-myfsnproduct-apiloadproductdata
        description: Load product data
        call: flower-shop-network.post-myfsnproduct-apiloadproductdata
        outputParameters:
        - type: object
          mapping: $.
    - path: /RelayUtil.apiSearchFlorists
      name: post-relayutil-apisearchflorists
      operations:
      - method: POST
        name: post-relayutil-apisearchflorists
        description: Search filling florists
        call: flower-shop-network.post-relayutil-apisearchflorists
        outputParameters:
        - type: object
          mapping: $.
    - path: /RelayOrder.apiGetOrder
      name: post-relayorder-apigetorder
      operations:
      - method: POST
        name: post-relayorder-apigetorder
        description: Retrieve order details
        call: flower-shop-network.post-relayorder-apigetorder
        outputParameters:
        - type: object
          mapping: $.
    - path: /RelayOrder.apiReceiveOrders
      name: post-relayorder-apireceiveorders
      operations:
      - method: POST
        name: post-relayorder-apireceiveorders
        description: Receive incoming orders awaiting accept/refuse
        call: flower-shop-network.post-relayorder-apireceiveorders
        outputParameters:
        - type: object
          mapping: $.
    - path: /RelayOrder.apiAcceptOrder
      name: post-relayorder-apiacceptorder
      operations:
      - method: POST
        name: post-relayorder-apiacceptorder
        description: Accept an incoming order
        call: flower-shop-network.post-relayorder-apiacceptorder
        outputParameters:
        - type: object
          mapping: $.
    - path: /RelayOrder.apiRefuseOrder
      name: post-relayorder-apirefuseorder
      operations:
      - method: POST
        name: post-relayorder-apirefuseorder
        description: Refuse an incoming order
        call: flower-shop-network.post-relayorder-apirefuseorder
        outputParameters:
        - type: object
          mapping: $.
    - path: /RelayOrder.apiSendOrder
      name: post-relayorder-apisendorder
      operations:
      - method: POST
        name: post-relayorder-apisendorder
        description: Send a florist-to-florist order
        call: flower-shop-network.post-relayorder-apisendorder
        outputParameters:
        - type: object
          mapping: $.
    - path: /RelayOrder.apiConfirmDelivery
      name: post-relayorder-apiconfirmdelivery
      operations:
      - method: POST
        name: post-relayorder-apiconfirmdelivery
        description: Confirm order delivery
        call: flower-shop-network.post-relayorder-apiconfirmdelivery
        outputParameters:
        - type: object
          mapping: $.
    - path: /RelayOrder.apiGetDeliveryConfirmation
      name: post-relayorder-apigetdeliveryconfirmation
      operations:
      - method: POST
        name: post-relayorder-apigetdeliveryconfirmation
        description: Retrieve delivery confirmation
        call: flower-shop-network.post-relayorder-apigetdeliveryconfirmation
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: flower-shop-network-mcp
    transport: http
    description: MCP adapter for Flower Shop Network JSON API for AI agent use.
    tools:
    - name: post-api-foreignsystem-apigetpostoken
      description: Issue API token
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flower-shop-network.post-api-foreignsystem-apigetpostoken
      outputParameters:
      - type: object
        mapping: $.
    - name: post-api-token-apicheck
      description: Validate token
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flower-shop-network.post-api-token-apicheck
      outputParameters:
      - type: object
        mapping: $.
    - name: post-myfsnproduct-apiloadproductdata
      description: Load product data
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flower-shop-network.post-myfsnproduct-apiloadproductdata
      outputParameters:
      - type: object
        mapping: $.
    - name: post-relayutil-apisearchflorists
      description: Search filling florists
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flower-shop-network.post-relayutil-apisearchflorists
      outputParameters:
      - type: object
        mapping: $.
    - name: post-relayorder-apigetorder
      description: Retrieve order details
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flower-shop-network.post-relayorder-apigetorder
      outputParameters:
      - type: object
        mapping: $.
    - name: post-relayorder-apireceiveorders
      description: Receive incoming orders awaiting accept/refuse
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flower-shop-network.post-relayorder-apireceiveorders
      outputParameters:
      - type: object
        mapping: $.
    - name: post-relayorder-apiacceptorder
      description: Accept an incoming order
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flower-shop-network.post-relayorder-apiacceptorder
      outputParameters:
      - type: object
        mapping: $.
    - name: post-relayorder-apirefuseorder
      description: Refuse an incoming order
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flower-shop-network.post-relayorder-apirefuseorder
      outputParameters:
      - type: object
        mapping: $.
    - name: post-relayorder-apisendorder
      description: Send a florist-to-florist order
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flower-shop-network.post-relayorder-apisendorder
      outputParameters:
      - type: object
        mapping: $.
    - name: post-relayorder-apiconfirmdelivery
      description: Confirm order delivery
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flower-shop-network.post-relayorder-apiconfirmdelivery
      outputParameters:
      - type: object
        mapping: $.
    - name: post-relayorder-apigetdeliveryconfirmation
      description: Retrieve delivery confirmation
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flower-shop-network.post-relayorder-apigetdeliveryconfirmation
      outputParameters:
      - type: object
        mapping: $.