营销API接口

营销API相关接口 如通过API对已有属性导入数据,请先在 属性设置页 设置属性英文名

HTTP头信息:

  1. Accept:application/json;charset=utf-8;
  2. Content-Type:application/x-www-form-urlencoded;charset=utf-8;

请求

批量会员信息同步接口

URL:https://api.yunpian.com/v2/crm/members/batch_sync.json

访问方式:POST

请求参数

参数名类型是否必传是否默认开放描述示例
apikeystring用户唯一标识,在管理控制台获取9b11127a9701975c734b8aee81ee3526
memberjson用户键值对转字符串的形式请参考下方示例

备注:member参数示例

  1. [
  2. {
  3. "customAttribute":
  4. {
  5. "age": "19",
  6. "name": "chen"
  7. },
  8. "mobile": "18300000547",
  9. "pushAttribute":
  10. {
  11. "getui":
  12. [
  13. {"cid":"cid1","appId":"appId1","masterSecret":"masterSecret1",
  14. appKey:"key1",appName:"app中文名1"},
  15. {"cid":"cid222","appId":"appId2","masterSecret":"masterSecret2",
  16. appKey:"key2",appName:"app中文名2"}
  17. ]
  18. }
  19. },
  20. {
  21. "customAttribute":
  22. {
  23. "age": "19",
  24. "name": "chen"
  25. },
  26. "mobile": "18300000548",
  27. "pushAttribute":
  28. {
  29. "getui":
  30. [
  31. {"cid":"cid1","appId":"appId1","masterSecret":"masterSecret1",
  32. appKey:"key1",appName:"app中文名1"},
  33. {"cid":"cid222","appId":"appId2","masterSecret":"masterSecret2",
  34. appKey:"key2",appName:"app中文名2"}
  35. ]
  36. }
  37. }
  38. ]

限制:

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

名称类型描述
codeinteger0
msgtextOK代表添加成功

Json返回示例

  1. {
  2. "code": 0,
  3. "msg": "OK"
  4. }