## 用户申请开店(入驻)(storeAdd) >[info] 场景说明:必须是未申请过店铺的用户,提交开店申请(入驻) ### 是否需要获取用户TOKEN `是` ***** ### 请求地址 ``` POST http://api.xxx.com/store/add ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 用户TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | store\_name | string | 必须 | 店铺名 | | stype | string | 必须 | 主体类型,取值:"company"=企业,"personal"=个人 | | sgrade | integer | 必须 | 店铺等级 | | owner\_name | string | 必须 | 主体名称,企业入驻填公司名,个人填姓名 | | tel | string | 必须 | 填手机号码 | | identity\_card | string | 可选 | 身份证号,个人入驻必填 | | identity\_front | string | 必须 | 身份证正面照图片路径 | | identity\_back | string | 必须 | 身份证反面照图片路径 | | business\_license | string | 可选 | 营业执照图片路径,企业入驻必填 | | region\_id | integer | 可选 | 店铺所在地省市区末级地区ID | | address | string | 可选 | 店铺所在地详细地址(不含省市区) | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "store_name": "牛人时装旗舰店", "stype": "company", "sgrade": 2, "tel": "19099999999", "identity_card": "", "identity_front": "https://www.shopwind.net/data/identity_front.jpg", "identity_back": "https://www.shopwind.net/data/identity_back.jpg", "business_license": "https://www.shopwind.net/data/business_license.jpg", "ower_name": "牛人", "region_id: 4, "address": "", } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | data | array | 必须 | 返回结果,如果没有数据则返回空 | 返回`data`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | store\_id | integer | 必须 | 店铺ID | | state | integer | 必须 | 店铺状态,0=审核中,1=开通,此处只有可能取值 0或1 | | apply\_remark | string | 可选 | 审核说明 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "store_id": 6, "state": 0, "apply_remark": "您的店铺申请已提交,审核后开通" } } ```