naftiko: 1.0.0-alpha2
info:
  label: HipChat REST API v2 — Emoticons
  description: HipChat emoticon catalog read access (historical; sunset 2019-02-15).
  tags: [HipChat, Emoticons, Sunset]
  created: '2026-05-23'
  modified: '2026-05-23'
  status: sunset
  sunsetDate: '2019-02-15'
binds:
- namespace: env
  keys:
    HIPCHAT_API_TOKEN: HIPCHAT_API_TOKEN
capability:
  consumes:
  - type: http
    namespace: hipchat-emoticons
    baseUri: https://api.hipchat.com/v2
    description: HipChat emoticon discovery.
    resources:
    - name: emoticons
      path: /emoticon
      operations:
      - name: listemoticons
        method: GET
        description: HipChat Get All Emoticons
        outputRawFormat: json
        outputParameters: [{name: result, type: object, value: $.}]
        inputParameters:
        - {name: start-index, in: query, type: integer}
        - {name: max-results, in: query, type: integer}
        - {name: type, in: query, type: string}
    - name: emoticon
      path: /emoticon/{emoticon_id_or_shortcut}
      operations:
      - {name: getemoticon, method: GET, description: HipChat Get Emoticon Details}
    authentication:
      type: bearer
      token: '{{env.HIPCHAT_API_TOKEN}}'
  exposes:
  - type: rest
    namespace: hipchat-emoticons-rest
    port: 8080
    description: REST adapter for HipChat Emoticons.
    resources:
    - path: /v1/emoticons
      name: emoticons
      operations:
      - {method: GET, name: listemoticons, call: hipchat-emoticons.listemoticons}
    - path: /v1/emoticons/{emoticon_id_or_shortcut}
      name: emoticon
      operations:
      - {method: GET, name: getemoticon, call: hipchat-emoticons.getemoticon}