获取蹊径微信号列表

所属权限 ads_management
请求地址 wx_package_account/get
请求方法 GET

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考

参数名称 参数类型
access_token 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节
timestamp

当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。

MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳

MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59

nonce 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性

请求参数

标有*的参数为必填项

名称 类型 描述
account_id*
integer 推广帐号 id,有操作权限的帐号 id,包括代理商和广告主帐号 id
page_size
integer 一页显示的数据条数
最小值 1,最大值 100
默认值:10
page_index
integer 搜索页码
最小值 1,最大值 99999
默认值:1
begin_time
string 检索时间,格式参考:20220908
字段长度最小 1 字节,长度最大 8 字节
end_time
string 检索时间,格式参考:20220908
字段长度最小 1 字节,长度最大 8 字节
keyword
string 微信号检索关键字
字段长度最小 1 字节,长度最大 20 字节

请求示例


curl -v -G 'https://api.e.qq.com/v3.0/wx_package_account/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'page_size=10' 
					

应答字段

名称 类型 描述
page_info
struct 分页配置信息
page
integer 搜索页码
默认值:1
page_size
integer 一页显示的数据条数
默认值:10
total_number
integer 总条数
total_page
integer 总页数
list
struct[] 微信号信息列表
wechat_id
integer 微信号 id
type
enum 微信号类型,[枚举详情]
name
string 微信号名称
nick_name
string 微信号昵称
code_url
string 微信号二维码地址
enable_falg
integer 启用状态,0:启用,1:关闭
is_deleted
integer 删除状态,0:正常,1:已删除
status_desc
string 微信号备案库状态
update_time
string 更新时间,格式参考:2022-09-08 11:45:36
create_time
string 创建时间,格式参考:2022-09-08 11:45:36

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "page_info": {
            "total_number": 1628,
            "page": 1,
            "page_size": 1,
            "total_page": 1628
        },
        "list": [
            {
                "wechat_id": 106669,
                "type": "PRIVATE",
                "name": "dsafd",
                "nick_name": "dsafd",
                "code_url": "http://advertiserdata-75598.gzc.vod.tencent-cloud.com/xjPersonWeixin_01e84a24194c1e53",
                "enable_falg": 0,
                "is_deleted": 0,
                "status_desc": "备案",
                "update_time": "2022-08-26 16:01:40",
                "create_time": "2022-08-26 14:25:30"
            }
        ]
    }
}

可视化调试工具