OPENID自动登录/注册

#  OPENID自动登录/注册接口 `公开`

## 支持场景
>  已支持：通过微信授权OPENID自动登录，当OPENID不存在时，自动注册为新的用户

## API描述
>  API描述：根据微信授权的OPENID登录或注册
>手机号非必填，但不能重复，如果不同openid对应同一个手机号，接口将会返回手机号重复异常。通过微信openid(企业启用unionid时用unionid)查询营销用户进行登录。如果用户不存在，则自动注册成一个消费者用户。

> 登录/注册成功后，接口返回用户Token信息，使用用户Token可调用相关业务接口

## 请求流程

>   1. 在超8平台中申请第三方系统的应用Access Key和密钥（线下）。
>   2. 第三方系统根据应用Access Key和密钥向系统发起**Access Token**申请【 [如何获取token](https://developers.yesno.com.cn/doc/57/ "如何获取token")】。
>   3. 三方系统调用防伪领域服务的开放接口进行数据对接。

## 请求信息

| 协议     | HTTPS                                                  |
|----------|--------------------------------------------------------|
| 请求方法 | POST                                                   |
| 请求路径 | /marketing/open/v1/third-customer-login/wechat-openid                  |

##  header头
请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/ "请求头")

###  传入参数

| 参数名称| 是否必填 | 参数类型 | 参数说明 |
|-----------|----------|----------|------------------|
| openid | 是       | String   | 微信Openid |
| unionid | 否       | String   | 微信UnionId（企业启用unionid时，必填）|
| appId| 是       | String   | 微信授权方AppId |
| appType | 是       | integer   | 微信授权方类型：1微信公众号，2微信小程序  |
| phoneNumber | 否       | String   | 手机号                              |
| nickname| 否       | String   | 微信昵称                                         |
| headImage| 否       | String   | 用户图像                           |
| gpsIp | 否       | String   | 注册地经纬度或者ip                                                   |
| location | 否       | String   | 注册地位置                                                   |
| country | 否       | String   | 国家（标记用户注册的位置区域）如中国 |
| province | 否       | String   | 省（标记用户注册的位置区域）如湖北省|
| city| 否       | String   | 市（标记用户注册的位置区域）如武汉市                                        |
| area  | 否       | String   | 区（标记用户注册的位置区域）如洪山区                                  |
| areaId | 否       | String   | 区域ID                    |

### 传出参数

| 参数名称  | 参数类型     | 参数说明                 |
|-----------|--------------|--------------------------|
| code      | String       | 状态：200 成功           |
| message   | String       | 信息                     |
| timestamp | Long         | 时间戳                   |
| traceId   | String       | 追踪id                   |
| data      | String(Json) | JsonObject格式，如下描述 |

Data返回对象说明

| 参数名称        | 参数类型 | 参数说明                                                      |
|-----------------|----------|---------------------------------------------------------------|
| id         | number   | 营销用户id                                                     |
| token       | String   | 营销用户登录后的token     |

### Code错误码说明
| 错误代码          | 描述                              |
|-------------------|-----------------------------------|
| 200               | 成功                              |
| 21213014 | 获取启用unionid参数失败  |
21213005  |微信UnionId不能为空 |
| 21213017          | 请求超时，请稍后重试                 |
| 21213001        | 用户被禁用                    |
| 21213014          | 手机号不可重复               |
| 21213018          | 登录异常，请稍后重试           |