Swetrix Statistics API — Traffic

naftiko: 1.0.0-alpha2
info:
  label: Swetrix Statistics API — Traffic
  description: 'Swetrix Statistics API — Traffic. 6 operations. Lead operation: Get Traffic Log. Self-contained Naftiko capability
    covering one Swetrix business surface.'
  tags:
  - Swetrix
  - Traffic
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SWETRIX_API_KEY: SWETRIX_API_KEY
capability:
  consumes:
  - type: http
    namespace: statistics-traffic
    baseUri: https://api.swetrix.com
    description: Swetrix Statistics API — Traffic business capability. Self-contained, no shared references.
    resources:
    - name: v1-log
      path: /v1/log
      operations:
      - name: gettrafficlog
        method: GET
        description: Get Traffic Log
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: mode
          in: query
          type: string
          description: Data aggregation mode
        - name: metrics
          in: query
          type: string
          description: Up to 3 custom metric objects (JSON array)
    - name: v1-log-birdseye
      path: /v1/log/birdseye
      operations:
      - name: getbirdseyesummary
        method: GET
        description: Get Birdseye Traffic Summary
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: pids
          in: query
          type: string
          description: Comma-separated list of project IDs (use pid or pids)
    - name: v1-log-filters
      path: /v1/log/filters
      operations:
      - name: getfilters
        method: GET
        description: Get Available Filter Values
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: type
          in: query
          type: string
          description: Dimension type to get filter values for
          required: true
    - name: v1-log-keywords
      path: /v1/log/keywords
      operations:
      - name: getkeywords
        method: GET
        description: Get Search Keywords
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-log-live-visitors
      path: /v1/log/live-visitors
      operations:
      - name: getlivevisitors
        method: GET
        description: Get Live Visitors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-log-user-flow
      path: /v1/log/user-flow
      operations:
      - name: getuserflow
        method: GET
        description: Get User Navigation Flow
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: X-Api-Key
      value: '{{env.SWETRIX_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: statistics-traffic-rest
    port: 8080
    description: REST adapter for Swetrix Statistics API — Traffic. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1/log
      name: v1-log
      description: REST surface for v1-log.
      operations:
      - method: GET
        name: gettrafficlog
        description: Get Traffic Log
        call: statistics-traffic.gettrafficlog
        with:
          mode: rest.mode
          metrics: rest.metrics
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/log/birdseye
      name: v1-log-birdseye
      description: REST surface for v1-log-birdseye.
      operations:
      - method: GET
        name: getbirdseyesummary
        description: Get Birdseye Traffic Summary
        call: statistics-traffic.getbirdseyesummary
        with:
          pids: rest.pids
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/log/filters
      name: v1-log-filters
      description: REST surface for v1-log-filters.
      operations:
      - method: GET
        name: getfilters
        description: Get Available Filter Values
        call: statistics-traffic.getfilters
        with:
          type: rest.type
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/log/keywords
      name: v1-log-keywords
      description: REST surface for v1-log-keywords.
      operations:
      - method: GET
        name: getkeywords
        description: Get Search Keywords
        call: statistics-traffic.getkeywords
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/log/live-visitors
      name: v1-log-live-visitors
      description: REST surface for v1-log-live-visitors.
      operations:
      - method: GET
        name: getlivevisitors
        description: Get Live Visitors
        call: statistics-traffic.getlivevisitors
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/log/user-flow
      name: v1-log-user-flow
      description: REST surface for v1-log-user-flow.
      operations:
      - method: GET
        name: getuserflow
        description: Get User Navigation Flow
        call: statistics-traffic.getuserflow
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: statistics-traffic-mcp
    port: 9090
    transport: http
    description: MCP adapter for Swetrix Statistics API — Traffic. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: get-traffic-log
      description: Get Traffic Log
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: statistics-traffic.gettrafficlog
      with:
        mode: tools.mode
        metrics: tools.metrics
      outputParameters:
      - type: object
        mapping: $.
    - name: get-birdseye-traffic-summary
      description: Get Birdseye Traffic Summary
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: statistics-traffic.getbirdseyesummary
      with:
        pids: tools.pids
      outputParameters:
      - type: object
        mapping: $.
    - name: get-available-filter-values
      description: Get Available Filter Values
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: statistics-traffic.getfilters
      with:
        type: tools.type
      outputParameters:
      - type: object
        mapping: $.
    - name: get-search-keywords
      description: Get Search Keywords
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: statistics-traffic.getkeywords
      outputParameters:
      - type: object
        mapping: $.
    - name: get-live-visitors
      description: Get Live Visitors
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: statistics-traffic.getlivevisitors
      outputParameters:
      - type: object
        mapping: $.
    - name: get-user-navigation-flow
      description: Get User Navigation Flow
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: statistics-traffic.getuserflow
      outputParameters:
      - type: object
        mapping: $.