注意：以下文档只适用于TOP接口，请谨慎使用！
注意：以下文档只适用于TOP接口，请谨慎使用！
会员通1.0产品实现了品牌会员身份识别的打通，但是会员入会之后仍无法实现多个渠道的会员身份建立，还需要在不同的场景下去引导用户完成多次绑定。外域入会接口，可以帮助品牌实现多端多场景的一键入会。
必须完成会员通1.0的接入
需要完成会员通保密协议签署
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| mobile | String | true | 150xxxx1672 | 手机号 |
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
错误码说明
| 错误码 | 错误信息 | 解决方案 |
|---|---|---|
| isv.invalid-parameter | 非法参数 | |
| isv.error-msm-sign | 短信签名获取异常 | |
| isv.send-too-many-times | 达到当天发送上限 | |
| isv.error_mobile_exist_risk | 手机号存在风险 | |
| isv.invalid-parameter-mobile | 无效的手机号 | |
| isp.system-error | 系统异常 |
接口：taobao.crm.member.sms.code.check
请求参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| mobile | String | true | 150xxxx1672 | 手机号 |
| code | String | true | 123654 | 验证码 |
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
错误码说明
| 错误码 | 错误信息 | 解决方案 |
|---|---|---|
| isv.invalid-parameter | 非法参数 | |
| isv.error-validate-code | 校验失败 | |
| isv.error-too-many-times | 失败次数达到上限 | |
| isv.validate_code_no_exist | 尚未发送验证码 | |
| isv.error_mobile_exist_risk | 手机号存在风险 | |
| isv.invalid-parameter-mobile | 无效的手机号 | |
| isp.system-error | 系统异常 |
（需要在发送短信验证码后15分钟内（且用户验证成功）请求入会接口）
接口：taobao.crm.member.sms.join
请求参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| mobile | String | true | 150xxxx1672 | 手机号 |
| ip | String | false | 11.22.33.44 | C端ip地址 |
| ext_info | String | false | “{"birthday":"1990-09-01","province":"ZheJiang","babyBirthday":"2020-09-01","city":"HangZhou","sex":"1","name":"zhangsan","storeId":"123456","employeeNo":"999","email":"test1234@163.com\"}” | 入会采集信息 |
注意:扩展信息是json结构的字符串，键和值都是String类型。且key必须在给定的范围，超过范围的信息将不会被采集
ext_info里面可采集的信息如下
| 获取信息 | 字段名称 | 示例 | 必填 |
|---|---|---|---|
| 姓名 | name | “zhangsan” | 否 |
| 性别 | sex | “1”:? 表示男性 “2”:? 表示女性 |
否 |
| 生日 | birthday | “1990-09-01” | 否 |
| 宝宝生日 | babyBirthday | “2020-09-01” | 否 |
| 省份 | province | “ZheJiang” | 否 |
| 城市 | city | “HangZhou” | 否 |
| 邮箱 | “xxx@qq.com” | 否 | |
| 门店ID | storeId | “300001” | 否 |
| 导购ID | employeeNo | “123456” | 否 |
门店ID和导购ID涉及到后续人群运营以及后续分佣，线下入会场景建议添加
1、门店ID：
-通过阿里接口维护门店信息，需填写自用门店编码；接口可参考：门店创建接口
-需要isv通过接口做一层自用门店编码转阿里内部门店ID的转化：接口可参考：门店信息查询接口
-该参数需传入阿里内部门店ID
2、导购ID：
-在新零售工作台维护导购员工信息，必须包括 员工工号
-该参数传入外部员工工号即可
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|
错误码说明
| 错误码 | 错误信息 | 解决方案 |
|---|---|---|
| isv.invalid-parameter | 参数错误 | |
| isv.invalid-parameter-mobile | 无效手机号 | |
| isv.already-member | 已入会 | |
| isv.bind-by-other | 手机号已绑定 | |
| isv.flight-mode | 飞行模式状态 | |
| isv.mobile-has-no-user | 手机号没有对应的淘宝账号 | |
| isv.error_mobile_not_check | 手机号未进行校验 | |
| isv.join-too-many-times | 入会操作太频繁 | |
| isp.system-error | 系统服务异常 |
