member/batch_get
目录 |
1.接口说明
1.1接口描述
批量获取会员档案
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
电商集成、会员管理
3.接口调用说明
3.1请求说明
url | https://api.yonyouup.com/api/member/batch_get |
格式 | JSON |
https请求方式 | GET |
3.2url参数说明
参数 | 是否必填 | 类型 | 描述 |
---|---|---|---|
from_account | 是 | sting | 调用方id |
to_account | 是 | string | 提供方id |
app_key | 是 | string | 应用编码 |
token | 是 | string | 全局访问唯一识别码 |
ds_sequence | 否 | number | 数据源序号(默认取应用的第一个数据源) |
ccode_begin | 否 | string | 起始会员编号 |
ccode_end | 否 | string | 结束会员编号 |
cname | 否 | string | 姓名关键字 |
cnickname | 否 | string | 昵称关键字 |
cgradename | 否 | string | 会员等级名称关键字 |
cmobilephone | 否 | string | 手机 |
cemail | 否 | string | |
cmicromessage | 否 | string | 微信号 |
cqqcode | 否 | string | QQ号 |
cvalidcardnum | 否 | string | 有效证件编号 |
cmemo | 否 | string | 备注关键字 |
crecommendcode | 否 | string | 推荐人编码 |
crecommendname | 否 | string | 推荐人名称关键字 |
cretailstorecode | 否 | string | 归属门店编码 |
cretailstorename | 否 | string | 归属门店名称关键字 |
imembersource | 否 | number | 会员来源 |
cphone | 否 | string | 联系电话 |
csex | 否 | string | 性别 |
cbuyfavor | 否 | string | 购买爱好 |
3.3请求示例
GET https://api.yonyouup.com/api/member/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=26d2fc4a06844448957a7f8260f3d08b&ccode_begin=xxxxx&ccode_end=xxxxx&cname=xxxxx&cnickname=xxxxx&cgradename=xxxxx&cmobilephone=xxxxx&cemail=xxxxx&cmicromessage=xxxxx&cqqcode=xxxxx&cvalidcardnum=xxxxx&cmemo=xxxxx&crecommendcode=xxxxx&crecommendname=xxxxx&cretailstorecode=xxxxx&cretailstorename=xxxxx&imembersource=xxxxx&cphone=xxxxx&csex=xxxxx&cbuyfavor=xxxxx
3.4返回参数说明
参数说明 | 类型 | 参数路径 | 描述 |
---|---|---|---|
errcode | string | 错误码,0 为正常。 | |
errmsg | string | 错误信息。 | |
ccode | string | 会员编号 | |
cname | string | 姓名 | |
cnickname | string | 昵称 | |
cgradename | string | 会员等级名称 | |
ddate | date | 会员注册日期 | |
dstopdate | date | 停用日期 | |
cmobilephone | string | 手机 | |
cemail | string | ||
cmicromessage | string | 微信号 | |
cqqcode | string | QQ号 | |
cprovince | string | 省 | |
ccity | string | 市 | |
carea | string | 区县 | |
caddress | string | 详细地址 | |
cvalidcardnum | string | 有效证件编号 | |
cvalidcard | string | 有效证件类型 | |
cmemo | string | 备注 | |
crecommendcode | string | 推荐人编码 | |
crecommendname | string | 推荐人名称 | |
cretailstorecode | string | 归属门店编码 | |
cretailstorename | string | 归属门店名称 | |
wechatmemberid | number | 易联会员Id | |
wechatrecommendmemberid | number | 易联推荐人Id | |
retailguid | string | 零售GUID | |
retailrecommendguid | string | 零售推荐人GUID | |
wechatrecommendtime | date | 易联推荐日期 | |
dlastbuydate | date | 最后购买日期 | |
retailrecommenddate | date | 零售推荐日期 | |
drecommenddate | date | 推荐日期 | |
isumbuycount | number | 累计购买次数 | |
fsumbuymoney | number | 累计购买金额 | |
imembersource | number | 会员来源 | |
cretailareacode | string | 门店地区编码 | |
cretailareaname | string | 门店地区 | |
cbrandcode | string | 品牌编码 | |
cbrandname | string | 品牌 | |
bstop | boolean | 是否停用 | |
cgradecode | string | 会员等级编号 | |
dbirthdate | date | 会员生日 | |
cphone | string | 联系电话 | |
czip | string | 邮编 | |
csex | string | 性别 | |
cbuyfavor | string | 购买爱好 | |
fmemberfee | number | 会员积分 | |
cprovinceid | string | 省id | |
ccityid | string | 市id | |
careaid | string | 区县id | |
cmaker | string | 制单人 | |
cpersoncode | string | 业务员编号 | |
cpersonname | string | 业务员 | |
cdefine1 | string | 表头自定义项1 | |
cdefine2 | string | 表头自定义项2 | |
cdefine3 | string | 表头自定义项3 | |
cdefine4 | date | 表头自定义项4 | |
cdefine5 | number | 表头自定义项5 | |
cdefine6 | date | 表头自定义项6 | |
cdefine7 | number | 表头自定义项7 | |
cdefine9 | string | 表头自定义项9 | |
cdefine10 | string | 表头自定义项10 | |
cdefine11 | string | 表头自定义项11 | |
cdefine12 | string | 表头自定义项12 | |
cdefine13 | string | 表头自定义项13 | |
cdefine15 | number | 表头自定义项15 | |
cdefine16 | number | 表头自定义项16 | |
cdefine14 | string | 表头自定义项14 | |
cdefine8 | string | 表头自定义项8 | |
cwechat | string | 微信绑定号 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8 { "member":[ { "ccode":"0000000001", "cmaker":"demo", "wechatrecommendmemberid":"", "wechatrecommendtime":"", "imembersource":"4", "cbuyfavor":"", "retailguid":"", "carea":"", "isumbuycount":"", "ddate":"2016-06-1200:00:00.0", "crecommendcode":"", "dstopdate":"", "crecommendname":"", "cphone":"", "drecommenddate":"", "retailrecommenddate":"", "cvalidcardnum":"", "cmemo":"", "cretailareaname":"", "cmicromessage":"", "cmobilephone":"", "retailrecommendguid":"", "cdefine12":"", "cdefine11":"", "cdefine10":"", "cemail":"", "cretailstorename":"", "czip":"", "cpersonname":"", "csex":"9", "ccityid":"", "cdefine14":"", "cdefine13":"", "cdefine16":"", "cdefine15":"", "fmemberfee":"", "cprovince":"", "cpersoncode":"", "bstop":"0", "cvalidcard":"", "cgradename":"永久钻石卡", "caddress":"", "cdefine9":"", "cdefine8":"", "cdefine7":"", "cretailstorecode":"", "cbrandcode":"", "dlastbuydate":"", "cdefine6":"", "cdefine5":"", "cdefine4":"", "cdefine3":"", "cdefine2":"", "cgradecode":"34767", "cdefine1":"", "careaid":"", "cqqcode":"", "dbirthdate":"", "fsumbuymoney":"", "cprovinceid":"", "ccity":"", "wechatmemberid":"", "cnickname":"test1", "cwechat":"", "cname":"test1", "cbrandname":"", "cretailareacode":"" }, { "ccode":"0000000002", "cmaker":"demo", "wechatrecommendmemberid":"", "wechatrecommendtime":"", "imembersource":"4", "cbuyfavor":"", "retailguid":"", "carea":"", "isumbuycount":"", "ddate":"2016-06-1200:00:00.0", "crecommendcode":"", "dstopdate":"", "crecommendname":"", "cphone":"", "drecommenddate":"", "retailrecommenddate":"", "cvalidcardnum":"", "cmemo":"", "cretailareaname":"", "cmicromessage":"", "cmobilephone":"", "retailrecommendguid":"", "cdefine12":"", "cdefine11":"", "cdefine10":"", "cemail":"", "cretailstorename":"", "czip":"", "cpersonname":"", "csex":"9", "ccityid":"", "cdefine14":"", "cdefine13":"", "cdefine16":"", "cdefine15":"", "fmemberfee":"", "cprovince":"", "cpersoncode":"", "bstop":"0", "cvalidcard":"", "cgradename":"永久钻石卡", "caddress":"", "cdefine9":"", "cdefine8":"", "cdefine7":"", "cretailstorecode":"", "cbrandcode":"", "dlastbuydate":"", "cdefine6":"", "cdefine5":"", "cdefine4":"", "cdefine3":"", "cdefine2":"", "cgradecode":"34767", "cdefine1":"", "careaid":"", "cqqcode":"", "dbirthdate":"", "fsumbuymoney":"", "cprovinceid":"", "ccity":"", "wechatmemberid":"", "cnickname":"test2", "cwechat":"", "cname":"test2", "cbrandname":"", "cretailareacode":"" } ], "page_index":"1", "rows_per_page":"20", "row_count":"225", "errmsg":"", "page_count":"12", "errcode":"0" }
3.6错误返回示例
application/json;charset=UTF-8 { "errcode":"30021", "errmsg":"此应用未上线" }