# 群发助手-状态查询
## OpenAPI Specification
```yaml
openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/api/qw/doApi:
post:
summary: 群发助手-状态查询
deprecated: false
description: >-
群发助手-状态查询
查询群发任务的执行状态与发送结果。
tags:
- 'API参考/会话与消息/消息模块 '
parameters:
- name: Content-Type
in: header
description: ''
required: true
example: application/json
schema:
type: string
- name: X-QIWEI-TOKEN
in: header
description: >-
进入 应用凭证，复制
TokenId。
required: true
example: '{{tokenId}}'
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
method:
type: string
title: 执行方法
description: >-
/msg/sendGroupMsgStatus
params:
type: object
properties:
guid:
type: string
title: 设备 ID
description: >-
设备唯一标识 guid，由「创建设备」接口返回，业务接口必传。
groupMsgId:
type: string
title: 群发消息id
description: ''
endDetailId:
type: integer
title: 用户状态列表最大查询量
description: ''
required:
- guid
- groupMsgId
- endDetailId
x-apifox-orders:
- guid
- groupMsgId
- endDetailId
title: 请求参数
required:
- method
- params
x-apifox-orders:
- method
- params
example:
method: /msg/sendGroupMsgStatus
params:
guid: '{{guid}}'
groupMsgId: '115258331353230686'
endDetailId: 2
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties:
code:
type: integer
title: 状态码
description: >-
状态码，0 成功。
data:
type: object
properties:
customerList:
type: array
items:
type: object
properties:
customId:
type: integer
title: 联系人userId
description: ''
detailId:
type: integer
title: 查询偏移
description: ''
seq:
type: integer
title: 序号
description: ''
status:
type: integer
title: "状态\_1成功\_2拒收(非好友) 3超出次数限制"
description: ''
adminId:
type: integer
title: 发送人
description: ''
required:
- customId
- detailId
- seq
- status
- adminId
x-apifox-orders:
- customId
- detailId
- seq
- status
- adminId
title: 用户状态列表
description: ''
hasSend:
type: boolean
title: 是否发送
description: ''
isEnd:
type: boolean
title: 是否End
description: ''
total:
type: integer
title: 总数
description: ''
required:
- customerList
- hasSend
- isEnd
- total
x-apifox-orders:
- customerList
- hasSend
- isEnd
- total
title: 响应数据
description: >-
业务数据。
msg:
type: string
title: 说明
description: >-
返回说明。
required:
- code
- data
- msg
x-apifox-orders:
- code
- data
- msg
example:
code: 0
data:
customerList:
- customId: 788144444444744
detailId: 2
seq: 30970727
status: 1
adminId: 1684444444407991
- customId: 788444444447664
detailId: 1
seq: 30970728
status: 1
adminId: 1684444444407991
hasSend: true
isEnd: true
total: 2
msg: 成功
headers: {}
x-apifox-name: 成功
security: []
x-apifox-folder: 'API参考/会话与消息/消息模块 '
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/7051713/apis/api-344613934-run
components:
schemas: {}
securitySchemes:
apiKey:
type: apikey
in: header
name: X-WECOM-TOKEN
servers:
- url: https://new.qiweapi.com/qiwe
description: 正式环境
security: []
```