获取企业全部发布列表
企业和第三方应用可通过该接口获取企业全部的发表内容
POST https://qw-openapi-tx.dustess.com/external_contact/v1/get_moment_list?accessToken=
字段 | 值 |
---|---|
Content-Type | application/json |
字段 | 类型 | 描述 | 是否必须 |
---|---|---|---|
accessToken | String | accessToken | true |
请求参数名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
start_time | Int | 数据起始时间 (时间戳) | true |
end_time | Int | 数据起始时间 (时间戳) | true |
qw_user_id | String | 朋友圈创建人ID(企微) | false |
cf_user_id | String | 朋友圈创建人ID(尘锋) | false |
filter_type | Int | 朋友圈类型。0:企业发表 1:个人发表 2:所有,包括个人创建以及企业创建,默认情况下为所有类型 | false |
cursor | String | 用于分页查询的游标,字符串类型,由上一次调用返回,首次调用可不填 | false |
limit | Int | 返回的最大记录数,整型,最大值20,默认值20,超过最大值时取默认值 | false |
qw_user_ids,cf_user_ids不能同时为空;
qw_user_ids优先级高于cf_user_ids;
此接口提供的数据以天为维度,查询的时间范围为[start_time,end_time],即前后均为闭区间,支持的最大查询跨度为30天;
客户最多可获取最近180天内的数据;
当传入的时间不为0点时间戳时,会向下取整,如传入1554296400(Wed Apr 3 21:00:00 CST 2019)会被自动转换为1554220800(Wed Apr 3 00:00:00 CST > 2019);
如传入多个员工ID,则表示获取这些员工总体的联系客户数据。
朋友圈记录的起止时间间隔不能超过30天
在朋友圈发表列表中,按时间只能取到(start_time, end_time)范围内的数据
web管理端会展示企业成员所有已经发表的朋友圈(包括已经删除朋友圈),而API接口将不会返回已经删除的朋友圈记录
{
"start_time": 1605000000,
"end_time": 1605172726,
"qw_user_id": "zhang san",
"cf_user_Id": "1",
"filter_type": 1,
"cursor": "CURSOR",
"limit": 10
}
响应参数名 | 类型 | 说明 |
---|---|---|
success | Bool | 是否成功 |
code | Int | 响应码 |
msg | String | 消息提示 |
data | Object | 返回数据 |
data.next_cursor | String | 分页游标,下次请求时填写以获取之后分页的记录,如果已经没有更多的数据则返回空 |
data.list | Object[] | 朋友圈列表 |
data.list.moment_id | String | 朋友圈id |
data.list.qw_creator | String | 朋友圈创建者企微userid,企业发表内容到客户的朋友圈接口创建的朋友圈不再返回该字段 |
data.list.cf_creator | String | 朋友圈创建者尘锋userid,企业发表内容到客户的朋友圈接口创建的朋友圈不再返回该字段 |
data.list.create_time | Int | 创建时间,时间戳 |
data.list.create_type | Int | 朋友圈创建来源。0:企业 1:个人 |
data.list.visible_type | Int | 可见范围类型 。0:部分可见 1:公开 |
data.list.text | Object | |
data.list.text.content | String | 文本消息结构 |
data.list.image | Object[] | 图片的media_id列表 |
data.list.image.media_id | String | 图片的media_id |
data.list.video | Object | |
data.list.video.media_id | String | 视频media_id |
data.list.video.thumb_media_id | String | 视频封面media_id |
data.list.link | Object | |
data.list.link.title | String | 网页链接标题 |
data.list.link.url | String | 网页链接url |
data.list.location | Object | |
data.list.location.latitude | String | 地理位置纬度 |
data.list.location.longitude | String | 地理位置经度 |
data.list.location.name | String | 地理位置名称 |
{
"success": true,
"code": 0,
"msg": "OK",
"data": {
"list": [
{
"moment_id": "momxxx",
"creator": "xxxx",
"create_time": 1650265732,
"create_type": 1,
"visible_type": 1,
"text": {
"content": "text"
},
"image": [
{
"media_id": "WWCISP_xxxxx"
}
],
"video": {
"media_id": "WWCISP_xxxxx",
"thumb_media_id": "WWCISP_xxxxx"
},
"link": {
"title": "腾讯网-QQ.COM",
"url": "https://www.qq.com"
},
"location": {
"latitude": "23.10647",
"longitude": "113.32446",
"name": "广州市 · 广州塔"
}
}
]
}
}
修改于 2024-09-20 09:52:33