# OB11Message

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths: {}
components:
  schemas:
    OB11Sender:
      x-schema-id: OB11Sender
      description: OneBot 11 发送者信息
      type: object
      properties:
        user_id:
          description: 发送者QQ号
          anyOf:
            - type: number
            - type: string
        nickname:
          description: 发送者昵称
          type: string
        card:
          description: 群名片
          type: string
        role:
          description: 角色
          type: string
        sex:
          description: 性别
          type: string
        age:
          description: 年龄
          type: number
        area:
          description: 地区
          type: string
        level:
          description: 等级
          type: string
        title:
          description: 头衔
          type: string
      required:
        - user_id
        - nickname
      x-apifox-orders:
        - user_id
        - nickname
        - card
        - role
        - sex
        - age
        - area
        - level
        - title
      x-apifox-folder: ''
    OB11MessageXml:
      x-schema-id: OB11MessageXml
      description: XML消息段
      type: object
      properties:
        type:
          enum:
            - xml
          type: string
        data:
          type: object
          properties:
            data:
              description: XML数据
              type: string
          required:
            - data
          x-apifox-orders:
            - data
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageVideo:
      x-schema-id: OB11MessageVideo
      description: 视频消息段
      type: object
      properties:
        type:
          enum:
            - video
          type: string
        data: &ref_0
          $ref: '#/components/schemas/FileBaseData'
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageText:
      x-schema-id: OB11MessageText
      description: 纯文本消息段
      type: object
      properties:
        type:
          enum:
            - text
          type: string
        data:
          type: object
          properties:
            text:
              description: 纯文本内容
              type: string
          required:
            - text
          x-apifox-orders:
            - text
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11Message:
      x-schema-id: OB11Message
      description: OneBot 11 完整消息对象
      type: object
      properties:
        real_seq:
          description: 真实序列号
          type: string
        temp_source:
          description: 临时会话来源
          type: number
        message_sent_type:
          description: 消息发送类型
          type: string
        target_id:
          description: 目标ID
          type: number
        self_id:
          description: 机器人QQ号
          type: number
        time:
          description: 消息时间戳
          type: number
        message_id:
          description: 消息ID
          type: number
        message_seq:
          description: 消息序列号
          type: number
        real_id:
          description: 真实ID
          type: number
        user_id:
          description: 发送者QQ号
          anyOf:
            - type: number
            - type: string
        group_id:
          description: 群号
          anyOf:
            - type: number
            - type: string
        group_name:
          description: 群名称
          type: string
        message_type:
          description: 消息类型
          enum:
            - private
            - group
          type: string
        sub_type:
          description: 消息子类型
          enum:
            - friend
            - group
            - normal
          type: string
        sender:
          $ref: '#/components/schemas/OB11Sender'
        message:
          description: 消息内容
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/OB11MessageData'
            - type: string
        message_format:
          description: 消息格式
          enum:
            - array
            - string
          type: string
        raw_message:
          description: 原始消息
          type: string
        font:
          description: 字体
          type: number
        post_type:
          description: 上报类型
          type: string
        raw:
          description: 原始消息对象
          type: object
          x-apifox-orders: []
        emoji_likes_list:
          description: 表情点赞列表
          type: array
          items:
            type: object
            properties:
              emoji_id:
                description: 表情ID
                type: string
              emoji_type:
                description: 表情类型
                type: string
              likes_cnt:
                description: 点赞数
                type: string
            required:
              - emoji_id
              - emoji_type
              - likes_cnt
            x-apifox-orders:
              - emoji_id
              - emoji_type
              - likes_cnt
      required:
        - time
        - message_id
        - message_seq
        - real_id
        - user_id
        - message_type
        - sender
        - message
        - message_format
        - raw_message
        - font
      x-apifox-orders:
        - real_seq
        - temp_source
        - message_sent_type
        - target_id
        - self_id
        - time
        - message_id
        - message_seq
        - real_id
        - user_id
        - group_id
        - group_name
        - message_type
        - sub_type
        - sender
        - message
        - message_format
        - raw_message
        - font
        - post_type
        - raw
        - emoji_likes_list
      x-apifox-folder: ''
    OB11MessageReply:
      x-schema-id: OB11MessageReply
      description: 回复消息段
      type: object
      properties:
        type:
          enum:
            - reply
          type: string
        data:
          type: object
          properties:
            id:
              description: 消息ID的短ID映射
              type: string
            seq:
              description: 消息序列号，优先使用
              type: number
          x-apifox-orders:
            - id
            - seq
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageRecord:
      x-schema-id: OB11MessageRecord
      description: 语音消息段
      type: object
      properties:
        type:
          enum:
            - record
          type: string
        data: *ref_0
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageRPS:
      x-schema-id: OB11MessageRPS
      description: 猜拳消息段
      type: object
      properties:
        type:
          enum:
            - rps
          type: string
        data:
          type: object
          properties:
            result:
              description: 猜拳结果
              anyOf:
                - type: number
                - type: string
          required:
            - result
          x-apifox-orders:
            - result
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessagePoke:
      x-schema-id: OB11MessagePoke
      description: 戳一戳消息段
      type: object
      properties:
        type:
          enum:
            - poke
          type: string
        data:
          type: object
          properties:
            type:
              description: 戳一戳类型
              type: string
            id:
              description: 戳一戳ID
              type: string
          required:
            - type
            - id
          x-apifox-orders:
            - type
            - id
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageOnlineFile:
      x-schema-id: OB11MessageOnlineFile
      description: 在线文件消息段
      type: object
      properties:
        type:
          enum:
            - onlinefile
          type: string
        data:
          type: object
          properties:
            msgId:
              description: 消息ID
              type: string
            elementId:
              description: 元素ID
              type: string
            fileName:
              description: 文件名
              type: string
            fileSize:
              description: 文件大小
              type: string
            isDir:
              description: 是否为目录
              type: boolean
          required:
            - msgId
            - elementId
            - fileName
            - fileSize
            - isDir
          x-apifox-orders:
            - msgId
            - elementId
            - fileName
            - fileSize
            - isDir
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageNode:
      x-schema-id: OB11MessageNode
      description: 合并转发消息节点
      type: object
      properties:
        type:
          enum:
            - node
          type: string
        data:
          type: object
          properties:
            id:
              description: 转发消息ID
              type: string
            user_id:
              description: 发送者QQ号
              anyOf:
                - type: number
                - type: string
            uin:
              description: 发送者QQ号(兼容go-cqhttp)
              anyOf:
                - type: number
                - type: string
            nickname:
              description: 发送者昵称
              type: string
            name:
              description: 发送者昵称(兼容go-cqhttp)
              type: string
            content:
              description: 消息内容 (OB11MessageMixType)
              type: object
              x-apifox-orders: []
            source:
              description: 消息来源
              type: string
            news:
              type: array
              items:
                type: object
                properties:
                  text:
                    description: 新闻文本
                    type: string
                required:
                  - text
                x-apifox-orders:
                  - text
            summary:
              description: 摘要
              type: string
            prompt:
              description: 提示
              type: string
            time:
              description: 时间
              type: string
          required:
            - nickname
            - content
          x-apifox-orders:
            - id
            - user_id
            - uin
            - nickname
            - name
            - content
            - source
            - news
            - summary
            - prompt
            - time
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageMiniApp:
      x-schema-id: OB11MessageMiniApp
      description: 小程序消息段
      type: object
      properties:
        type:
          enum:
            - miniapp
          type: string
        data:
          type: object
          properties:
            data:
              description: 小程序数据
              type: string
          required:
            - data
          x-apifox-orders:
            - data
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageMarkdown:
      x-schema-id: OB11MessageMarkdown
      description: Markdown消息段
      type: object
      properties:
        type:
          enum:
            - markdown
          type: string
        data:
          type: object
          properties:
            content:
              description: Markdown内容
              type: string
          required:
            - content
          x-apifox-orders:
            - content
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageMFace:
      x-schema-id: OB11MessageMFace
      description: 商城表情消息段
      type: object
      properties:
        type:
          enum:
            - mface
          type: string
        data:
          type: object
          properties:
            emoji_package_id:
              description: 表情包ID
              type: number
            emoji_id:
              description: 表情ID
              type: string
            key:
              description: 表情key
              type: string
            summary:
              description: 表情摘要
              type: string
          required:
            - emoji_package_id
            - emoji_id
            - key
            - summary
          x-apifox-orders:
            - emoji_package_id
            - emoji_id
            - key
            - summary
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageLocation:
      x-schema-id: OB11MessageLocation
      description: 位置消息段
      type: object
      properties:
        type:
          enum:
            - location
          type: string
        data:
          type: object
          properties:
            lat:
              description: 纬度
              anyOf:
                - type: string
                - type: number
            lon:
              description: 经度
              anyOf:
                - type: string
                - type: number
            title:
              description: 标题
              type: string
            content:
              description: 内容
              type: string
          required:
            - lat
            - lon
          x-apifox-orders:
            - lat
            - lon
            - title
            - content
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageJson:
      x-schema-id: OB11MessageJson
      description: JSON消息段
      type: object
      properties:
        type:
          enum:
            - json
          type: string
        data:
          type: object
          properties:
            data:
              description: JSON数据
              anyOf:
                - type: string
                - type: object
                  properties: {}
                  x-apifox-orders: []
            config:
              type: object
              properties:
                token:
                  description: token
                  type: string
              required:
                - token
              x-apifox-orders:
                - token
          required:
            - data
          x-apifox-orders:
            - data
            - config
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageImage:
      x-schema-id: OB11MessageImage
      description: 图片消息段
      type: object
      properties:
        type:
          enum:
            - image
          type: string
        data:
          allOf:
            - description: 文件消息段基础数据
              type: object
              properties:
                file:
                  description: 文件路径/URL/file:///
                  type: string
                path:
                  description: 文件路径
                  type: string
                url:
                  description: 文件URL
                  type: string
                name:
                  description: 文件名
                  type: string
                thumb:
                  description: 缩略图
                  type: string
              required:
                - file
              x-apifox-orders:
                - file
                - path
                - url
                - name
                - thumb
            - type: object
              properties:
                summary:
                  description: 图片摘要
                  type: string
                sub_type:
                  description: 图片子类型
                  type: number
              x-apifox-orders:
                - summary
                - sub_type
          x-apifox-orders: []
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageIdMusic:
      x-schema-id: OB11MessageIdMusic
      description: ID音乐消息段
      type: object
      properties:
        type:
          enum:
            - music
          type: string
        data:
          type: object
          properties:
            type:
              description: 音乐平台类型
              enum:
                - qq
                - '163'
                - kugou
                - migu
                - kuwo
              type: string
            id:
              description: 音乐ID
              anyOf:
                - type: string
                - type: number
          required:
            - type
            - id
          x-apifox-orders:
            - type
            - id
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageForward:
      x-schema-id: OB11MessageForward
      description: 合并转发消息段
      type: object
      properties:
        type:
          enum:
            - forward
          type: string
        data:
          type: object
          properties:
            id:
              description: 合并转发ID
              type: string
            content:
              description: 消息内容 (OB11Message[])
              type: object
              x-apifox-orders: []
          required:
            - id
          x-apifox-orders:
            - id
            - content
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageFlashTransfer:
      x-schema-id: OB11MessageFlashTransfer
      description: QQ闪传消息段
      type: object
      properties:
        type:
          enum:
            - flashtransfer
          type: string
        data:
          type: object
          properties:
            fileSetId:
              description: 文件集ID
              type: string
          required:
            - fileSetId
          x-apifox-orders:
            - fileSetId
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageFile:
      x-schema-id: OB11MessageFile
      description: 文件消息段
      type: object
      properties:
        type:
          enum:
            - file
          type: string
        data: *ref_0
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageFace:
      x-schema-id: OB11MessageFace
      description: QQ表情消息段
      type: object
      properties:
        type:
          enum:
            - face
          type: string
        data:
          type: object
          properties:
            id:
              description: 表情ID
              type: string
            resultId:
              description: 结果ID
              type: string
            chainCount:
              description: 连击数
              type: number
          required:
            - id
          x-apifox-orders:
            - id
            - resultId
            - chainCount
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageDice:
      x-schema-id: OB11MessageDice
      description: 骰子消息段
      type: object
      properties:
        type:
          enum:
            - dice
          type: string
        data:
          type: object
          properties:
            result:
              description: 骰子结果
              anyOf:
                - type: number
                - type: string
          required:
            - result
          x-apifox-orders:
            - result
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageData:
      x-schema-id: OB11MessageData
      description: OneBot 11 消息段
      anyOf:
        - $ref: '#/components/schemas/OB11MessageText'
        - $ref: '#/components/schemas/OB11MessageFace'
        - $ref: '#/components/schemas/OB11MessageMFace'
        - $ref: '#/components/schemas/OB11MessageAt'
        - $ref: '#/components/schemas/OB11MessageReply'
        - $ref: '#/components/schemas/OB11MessageImage'
        - $ref: '#/components/schemas/OB11MessageRecord'
        - $ref: '#/components/schemas/OB11MessageVideo'
        - $ref: '#/components/schemas/OB11MessageFile'
        - $ref: '#/components/schemas/OB11MessageIdMusic'
        - $ref: '#/components/schemas/OB11MessageCustomMusic'
        - $ref: '#/components/schemas/OB11MessagePoke'
        - $ref: '#/components/schemas/OB11MessageDice'
        - $ref: '#/components/schemas/OB11MessageRPS'
        - $ref: '#/components/schemas/OB11MessageContact'
        - $ref: '#/components/schemas/OB11MessageLocation'
        - $ref: '#/components/schemas/OB11MessageJson'
        - $ref: '#/components/schemas/OB11MessageXml'
        - $ref: '#/components/schemas/OB11MessageMarkdown'
        - $ref: '#/components/schemas/OB11MessageMiniApp'
        - $ref: '#/components/schemas/OB11MessageNode'
        - $ref: '#/components/schemas/OB11MessageForward'
        - $ref: '#/components/schemas/OB11MessageOnlineFile'
        - $ref: '#/components/schemas/OB11MessageFlashTransfer'
      x-apifox-folder: ''
    OB11MessageCustomMusic:
      x-schema-id: OB11MessageCustomMusic
      description: 自定义音乐消息段
      type: object
      properties:
        type:
          enum:
            - music
          type: string
        data:
          type: object
          properties:
            type:
              description: 音乐平台类型
              enum:
                - qq
                - '163'
                - kugou
                - migu
                - kuwo
                - custom
              type: string
            id:
              type: 'null'
            url:
              description: 点击后跳转URL
              type: string
            audio:
              description: 音频URL
              type: string
            title:
              description: 音乐标题
              type: string
            image:
              description: 封面图片URL
              type: string
            content:
              description: 音乐简介
              type: string
          required:
            - type
            - id
            - url
            - image
          x-apifox-orders:
            - type
            - id
            - url
            - audio
            - title
            - image
            - content
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageContact:
      x-schema-id: OB11MessageContact
      description: 联系人消息段
      type: object
      properties:
        type:
          enum:
            - contact
          type: string
        data:
          type: object
          properties:
            type:
              description: 联系人类型
              enum:
                - qq
                - group
              type: string
            id:
              description: 联系人ID
              type: string
          required:
            - type
            - id
          x-apifox-orders:
            - type
            - id
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    OB11MessageAt:
      x-schema-id: OB11MessageAt
      description: '@消息段'
      type: object
      properties:
        type:
          enum:
            - at
          type: string
        data:
          type: object
          properties:
            qq:
              description: QQ号或all
              type: string
            name:
              description: 显示名称
              type: string
          required:
            - qq
          x-apifox-orders:
            - qq
            - name
      required:
        - type
        - data
      x-apifox-orders:
        - type
        - data
      x-apifox-folder: ''
    FileBaseData:
      x-schema-id: FileBaseData
      description: 文件消息段基础数据
      type: object
      properties:
        file:
          description: 文件路径/URL/file:///
          type: string
        path:
          description: 文件路径
          type: string
        url:
          description: 文件URL
          type: string
        name:
          description: 文件名
          type: string
        thumb:
          description: 缩略图
          type: string
      required:
        - file
      x-apifox-orders:
        - file
        - path
        - url
        - name
        - thumb
      x-apifox-folder: ''
  securitySchemes: {}
servers: []
security: []

```
