私域用户备案信息查询

¥收费高级接口

请求方法

接口地址:http://api.tkurl.top/api/alimama/publisherinfo

支持格式:json

请求方式:get

Session获取地址:http://api.tkurl.top/authorize?appkey=

请求示例:http://api.tkurl.top/api/alimama/publisherinfo?Appkey=&relation_app=common&info_type=1&session=

请求参数说明:

名称 类型 是否必须 示例值 描述
Appkey String 必填 123456 appkey
session String 必填 授权后,再授权页面获取 。(有效期30天)
info_type Number 必填 1 类型,必选 1:渠道信息;2:会员信息
relation_app String 必填 common 备案的场景:common(通用备案),etao(一淘备案),minietao(一淘小程序备案),offlineShop(线下门店备案),offlinePerson(线下个人备案)。如不填默认common。查询会员信息只需填写common即可
relation_id int 可选 11 渠道独占 - 渠道关系ID
page_no int 可选 1 第几页D
page_size int 可选 10 每页大小
special_id String 可选 1211 会员独占 - 会员运营ID
external_id String 可选 12345 淘宝客外部用户标记,如自身系统账户ID;微信ID等
external_type int 可选 0 1-微信、2-微博、3-抖音、4-快手、5-QQ,0-其他;默认为0

响应参数

名称
类型
示例值
描述
data
Data
data
root_pid_channel_list
String[]
["mm_1_1_1"]
渠道专属pidList
total_count
Number
40
共享字段 - 总记录数
inviter_list
MapData[]
inviterList
共享字段 - 渠道或会员列表
relation_app
String
common
共享字段 - 备案场景:common(通用备案),etao(一淘备案),minietao(一淘小程序备案),offlineShop(线下门店备案),offlinePerson(线下个人备案)
create_date
Date
2018-06-01 11:12:23
共享字段 - 备案日期
account_name
String
s**x
渠道独有 - 渠道昵称
real_name
String
xxx
渠道独有 - 渠道姓名
relation_id
Number
40232
渠道独有 - 渠道关系ID
offline_scene
String
门店
渠道独有 - 线下场景信息,1 - 门店,2- 学校,3 - 工厂,4 - 其他
online_scene
String
微信群
渠道独有 - 线上场景信息,1 - 微信群,2- QQ群,3 - 其他
note
String
小蜜蜂
渠道独有 - 媒体侧渠道备注信息
root_pid
String
mm_1_1_1
共享字段 - 渠道/会员专属pid
rtag
String
123
共享字段 - 渠道/会员原始身份信息
offline_info
RegisterInfoDto
线下
线下备案专属信息
shop_name
String
日用百货店
渠道独有 -店铺名称
shop_type
String
生活服务类 电信营业厅
渠道独有 -店铺类型
phone_number
String
1590000000
渠道独有 -手机号码
detail_address
String
**街道**号楼
渠道独有 -详细地址
location
String
内蒙古自治区 呼和浩特市
渠道独有 -地区
shop_certify_type
String
营业执照
渠道独有 -证件类型
certify_number
String
123445677
渠道独有 -对应的证件证件类型编号
career
String
个人 快递员
渠道独有 -经营类型
special_id
Number
12345
会员独有 - 会员运营ID
punish_status
String
1
渠道独有 - 处罚状态
external_id
String
12345
淘宝客外部用户标记,如自身系统账户ID;微信ID等
external_type
String
1
1-微信、2-微博、3-抖音、4-快手、5-QQ,0-其他

响应示例

{
    "tbk_sc_publisher_info_get_response":{
        "data":{
            "root_pid_channel_list":{
                "string":[
                    "[\"mm_1_1_1\"]"
                ]
            },
            "total_count":40,
            "inviter_list":{
                "map_data":[
                    {
                        "relation_app":"common",
                        "create_date":"2018-06-01 11:12:23",
                        "account_name":"s**x",
                        "real_name":"xxx",
                        "relation_id":40232,
                        "offline_scene":"门店",
                        "online_scene":"微信群",
                        "note":"小蜜蜂",
                        "root_pid":"mm_1_1_1",
                        "rtag":"123",
                        "offline_info":{
                            "shop_name":"日用百货店",
                            "shop_type":"生活服务类 电信营业厅",
                            "phone_number":"1590000000",
                            "detail_address":"**街道**号楼",
                            "location":"内蒙古自治区 呼和浩特市",
                            "shop_certify_type":"营业执照",
                            "certify_number":"123445677",
                            "career":"个人 快递员"
                        },
                        "special_id":12345,
                        "punish_status":"1",
                        "external_id":"12345",
                        "external_type":"1"
                    }
                ]
            }
        }
    }
}
   

异常示例

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}
   

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter 参数填写不正确 参数填写不正确
603 未找到用户或该用户未注册 请输入正确的appkey
604 未知参数错误 建议加入重试机制
404 参数传入错误_未知参数 检查参数类型是否正确