营销API接口
营销API相关接口 如通过API对已有属性导入数据,请先在 属性设置页 设置属性英文名。
HTTP头信息:
Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;
请求
批量会员信息同步接口
URL:https://api.yunpian.com/v2/crm/members/batch_sync.json
访问方式:POST
请求参数
参数名 | 类型 | 是否必传 | 是否默认开放 | 描述 | 示例 |
---|---|---|---|---|---|
apikey | string | 是 | 是 | 用户唯一标识,在管理控制台获取 | 9b11127a9701975c734b8aee81ee3526 |
member | json | 是 | 是 | 用户键值对转字符串的形式 | 请参考下方示例 |
备注:member参数示例
[
{
"customAttribute":
{
"age": "19",
"name": "chen"
},
"mobile": "18300000547",
"pushAttribute":
{
"getui":
[
{"cid":"cid1","appId":"appId1","masterSecret":"masterSecret1",
appKey:"key1",appName:"app中文名1"},
{"cid":"cid222","appId":"appId2","masterSecret":"masterSecret2",
appKey:"key2",appName:"app中文名2"}
]
}
},
{
"customAttribute":
{
"age": "19",
"name": "chen"
},
"mobile": "18300000548",
"pushAttribute":
{
"getui":
[
{"cid":"cid1","appId":"appId1","masterSecret":"masterSecret1",
appKey:"key1",appName:"app中文名1"},
{"cid":"cid222","appId":"appId2","masterSecret":"masterSecret2",
appKey:"key2",appName:"app中文名2"}
]
}
}
]
限制:
member
结构说明:
- member 目前只支持 mobile、customAttribute 2个字段,并且必须得包含 mobile,匹配到 mobile 的数据则更新原数据,否则会新插入一条数据
自定义字段全部放在 customAttribute 中
customAttribute
说明:key 只支持英文字符(a-zA-Z)或数字 (0-9),忽略大小写
- value 只支持:String 和 Number。数组、对象等类型不支持。
- key、value 的长度不能超过 100
最多只支持 100 个自定义 key
pushAttribute
说明:getui指个推,目前推送暂时只支持个推的app
- getui数组内目前最多支持10个对象
- cid、appId、masterSecret、appKey必传,appName可选
Response
名称 | 类型 | 描述 |
---|---|---|
code | integer | 0 |
msg | text | OK代表添加成功 |
Json返回示例
{
"code": 0,
"msg": "OK"
}