# 发送群公告

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /_send_group_notice:
    post:
      summary: 发送群公告
      deprecated: false
      description: 在指定群聊中发布新的公告
      tags:
        - Go-CQHTTP
        - Go-CQHTTP
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                group_id:
                  description: 群号
                  type: string
                content:
                  description: 公告内容
                  type: string
                image:
                  description: 公告图片路径或 URL
                  type: string
                pinned:
                  default: 0
                  description: 是否置顶 (0/1)
                  anyOf:
                    - type: number
                    - type: string
                type:
                  default: 1
                  description: 类型 (默认为 1)
                  anyOf:
                    - type: number
                    - type: string
                confirm_required:
                  default: 1
                  description: 是否需要确认 (0/1)
                  anyOf:
                    - type: number
                    - type: string
                is_show_edit_card:
                  default: 0
                  description: 是否显示修改群名片引导 (0/1)
                  anyOf:
                    - type: number
                    - type: string
                tip_window_type:
                  default: 0
                  description: 弹窗类型 (默认为 0)
                  anyOf:
                    - type: number
                    - type: string
              required:
                - group_id
                - content
                - pinned
                - type
                - confirm_required
                - is_show_edit_card
                - tip_window_type
              x-apifox-orders:
                - group_id
                - content
                - image
                - pinned
                - type
                - confirm_required
                - is_show_edit_card
                - tip_window_type
              x-apifox-ignore-properties: []
            examples:
              Default:
                value:
                  group_id: '123456'
                  content: 公告内容
                  image: base64://...
                summary: 默认请求示例
      responses:
        '200':
          description: 业务响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/BaseResponse'
                  - type: object
                    required:
                      - data
                    properties:
                      data:
                        type: 'null'
                        description: 业务数据
                    x-apifox-orders:
                      - data
                    x-apifox-ignore-properties: []
              examples:
                Success:
                  summary: 成功响应
                  value:
                    status: ok
                    retcode: 0
                    data: {}
                    message: ''
                    wording: ''
                    stream: normal-action
                Error_1400:
                  summary: 请求参数错误或业务逻辑执行失败
                  value:
                    status: failed
                    retcode: 1400
                    data: null
                    message: 请求参数错误或业务逻辑执行失败
                    wording: 请求参数错误或业务逻辑执行失败
                    stream: normal-action
                Error_1401:
                  summary: 权限不足
                  value:
                    status: failed
                    retcode: 1401
                    data: null
                    message: 权限不足
                    wording: 权限不足
                    stream: normal-action
                Error_1404:
                  summary: 资源不存在
                  value:
                    status: failed
                    retcode: 1404
                    data: null
                    message: 资源不存在
                    wording: 资源不存在
                    stream: normal-action
          headers: {}
          x-apifox-name: 成功
      security: []
      x-apifox-folder: Go-CQHTTP
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/5348325/apis/api-226658740-run
components:
  schemas:
    BaseResponse:
      type: object
      x-schema-id: BaseResponse
      properties:
        status:
          type: string
          description: 状态 (ok/failed)
        retcode:
          type: number
          description: 返回码
        data:
          type: string
        message:
          type: string
          description: 消息
        wording:
          type: string
          description: 提示
        stream:
          type: string
          description: 流式响应
          enum:
            - stream-action
            - normal-action
      required:
        - status
        - retcode
      x-apifox-orders:
        - status
        - retcode
        - data
        - message
        - wording
        - stream
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes: {}
servers: []
security: []

```