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":"此应用未上线"
}