feiwa:api_document

# FeiWa【B2B2C】平台系统接口文档

## 数据格式约定

返回数据为json格式，code为200表示数据正常，code为400表示数据出错，datas为返回的数据

    {code: 200, datas: {}}

### 分页参数

    支持分页的接口，拼接以下参数到请求URL

- page 每页商品数量(默认5)
- curpage 当前页数

### 返回值

#### 获取数据

    //有内容直接返回数组，无内容返回空数组[]
    //hasmore为是否有下一页
    //page_total为总页数
    {"code":200,"hasmore":true,"page_total":10,"datas":{"goods_list":[]}}

#### 操作成功

    //code返回code为200，datas返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回code为400，error内为错误信息
    {"code":400,"datas":{"error":"参数错误"}}
    //登录失败，login:0
    {"code":400,"login":"0","datas":{"error":"\u8bf7\u767b\u9646"}}

## 工具接口

### 获取验证码标识

#### 调用接口

      index.php?app=seccode&feiwa=makecodekey

##### 返回数据说明

- codekey 验证码标识字符串

### 获取验证码

#### 调用接口(get)

      index.php?app=seccode&feiwa=makecode

#### 请求参数

- k 由“获取验证码标识”接口得到的验证码标识

#### 返回数据

- 验证码图片

## 商城

### 首页

#### 调用接口(get)

      index.php?app=index

#### 请求参数

- type json/html json格式或者html页面

#### 返回数据

- special_id 专题id
- special_desc 专题描述
- list
  - adv_list
  - home1
  - home2
  - home3
  - home4
  - goods

##### 返回数据说明

- image 图片地址
- type 操作类型
  - keyword 搜索关键字
  - special 专题编号
  - goods 商品编号
  - url 地址
- data 与操作类型对应的数据内容

### 专题

#### 专题接口(get)

      index.php?app=index&feiwa=special

#### 请求参数

- special_id 专题编号
- type json/html json格式或者html页面

#### 返回数据

- adv_list
- home1
- home2
- home3
- home4
- goods

##### 返回数据说明

- image 图片地址
- type 操作类型
  - keywork 搜索关键字
  - special 专题编号
  - goods 商品编号
  - url 地址
- data 与操作类型对应的数据内容

### 商品分类

#### 调用接口(get)

      index.php?app=goods_class

#### 请求参数

- gc_id 分类id(可不填)

#### 返回数据

- class_list[]
  - gc_id 分类id
  - gc_name 分类名称

### 商品分类全部子集

#### 调用接口(get)

      index.php?app=goods_class&feiwa=get_child_all

#### 请求参数

- gc_id 一级分类id

#### 返回数据

- class_list[]
  - gc_id 分类id
  - gc_name 分类名称
  - child[]
    - gc_id 分类id
    - gc_name 分类名称

### 商品列表

#### 调用接口(get)

      index.php?app=goods&feiwa=goods_list

#### 请求参数

- key 排序方式 1-销量 2-浏览量 3-价格 空-按最新发布排序
- order 排序方式 1-升序 2-降序
- page 每页数量
- curpage 当前页码
- gc_id 分类编号
- keyword 搜索关键字
- barcode 商品条形码
- b_id 品牌id
- gc_id、keyword、barcode、b_id 四选一不能同时出现
- own_mall 是否自营 1是
- gift 是否赠品 1是
- area_id 一级地区ID
- ci 消保ID，多个消保时ID以英文下划线“_”分隔,如 2_7_8
- groupbuy 是否是团购 1是
- xianshi 是否是限时折扣 1是
- price_from 价格筛选下限
- price_to 价格筛选上限

#### 返回数据

- goods_id 商品编号
- goods_name 商品名称
- goods_price 商品价格
- goods_marketprice 商品市场价
- goods_salenum 销量
- evaluation_good_star 评价星级
- evaluation_count 评价数
- sole_flag 是否手机专享
- group_flag 是否团购
- xianshi_flag 是否限时折扣
- goods_image 图片名称
- goods_image_url 图片地址
- is_fcode 是否为F码商品 1是 0否
- is_appoint 是否是预约商品 1是 0否
- is_presell 是否是预售商品 1是 0否
- have_gift 是否拥有赠品 1是 0否
- goods_jingle 商品广告词
- store_id 店铺id
- store_name 店铺名称
- is_own_mall 是否是自营店铺，1是 0否

### 高级筛选

#### 调用接口(get)

      index.php?app=index&feiwa=search_adv

#### 请求参数

- 无

#### 返回数据

- area_list 一级地区列表（省级）
  - area_id 地区ID
  - area_name 地区名称
- contract_list 消费都保障内容列表
  - id 消保ID
  - name 消保名称

#### 示例

      {"code":200,"datas":{"area_list":[{"area_id":"1","area_name":"天津"}],"contract_list":[{"id":"1","name":"7天无理由退货"}]}}

### 搜索框时时下拉联想提示词

#### 调用接口(get)

      index.php?app=goods&feiwa=auto_complete

#### 请求参数

- term 搜索词

#### 返回数据

- list 联想词数组

### 商品详细信息

#### 调用接口(get)

      index.php?app=goods&feiwa=goods_detail

#### 请求参数

- goods_id 商品编号
- area_id 二级地区ID
- key 登录令牌(可选，如果提交返回是否已经收藏和购物车数量)

#### 返回数据

- goods_info 商品信息
  - goods_name 商品名称
  - goods_jingle 商品说明
  - spec_name 规格名称
  - spec_value 规格名
  - goods_price 商品价格
  - goods_marketprice 商品市场价
  - goods_id 商品编号
  - goods_click 商品点击数
  - goods_commentnum 商品评论数
  - goods_salenum 商品销量
  - goods_spec 商品规格
  - goods_storage 商品库存
  - evaluation_good_star 评价等级
  - evaluation_count 评价数
  - promotion_type 促销类型 groupbuy-团购 xianshi-限时折扣 sole-手机专享(没有不出现)
  - promotion_price 促销价格(没有不出现)
  - goods_promotion_type 促销类型 1-团购 2-限时折扣 默认0
  - goods_promotion_price 促销价格
  - upper_limit 最多购买数
  - is_virtual 是否为虚拟商品 1-是 0-否
  - virtual_indate 虚拟商品有效期
  - virtual_limit 虚拟商品购买上限
  - is_fcode 是否为F码商品 1-是 0-否
  - is_appoint 是否是预约商品 1-是 0-否
  - is_presell 是否是预售商品 1-是 0-否
  - have_gift 是否拥有赠品 1-是 0-否
  - cart 加入购物车是否显示 1-是 0-否
  - goods_url Web端商品url
  - contractlist[]消保列表
    - cti_id 自增id
    - cti_name 名称
    - cti_describe 描述
    - cti_cost
    - cti_icon
    - cti_descurl
    - cti_state 状态
    - cti_sort 排序
    - cti_state_key
    - cti_state_text
    - cti_icon_url 大图链接
    - cti_icon_url_60 小图图链接
    - cti_state_name
- store_info
  - store_id 店铺ID
  - store_name 店铺名称
  - member_id 店主ID
  - member_name 店主名称
  - goods_count 店铺商品数
  - is_own_mall 是否是自营店铺，自营店铺没有店铺动态评分，没有进入店铺按钮
  - store_credit 店铺动态评价
    - store_desccredit
      - text 评价文字
      - credit 评价值
      - percent 百分比
      - percent_class 百分比样式
      - percent_text 百分比文字
    - store_servicecredit
      - text 评价文字
      - credit 评价值
      - percent 百分比
      - percent_class 百分比样式
      - percent_text 百分比文字
    - store_deliverycredit
      - text 评价文字
      - credit 评价值
      - percent 百分比
      - percent_class 百分比样式
      - percent_text 百分比文字
- spec_list 规格列表
- gift_array 赠品数组
- spec_image 规格图片
- goods_image 商品图片
- goods_commend_list 推荐商品列表
  - goods_id 商品编号
  - goods_name 商品名称
  - goods_price 商品价格
  - goods_promotion_price 促销价格
  - goods_image_url 商品图片
- mansong_info 满即送信息
  - mansong_name 活动名称
  - start_time 开始时间
  - end_time 结束时间
  - price 活动金额
  - discount 减现金
  - mansong_goods_name 赠送商品名称
  - goods_id 赠送商品编号，goods_id为0时为无赠品
  - goods_image_url 赠送商品图片地址
- is_favorate 是否已经收藏(请求时需提交key)
- voucher[] 店铺代金券（请求时需提交key）
  - voucher_t_id 代金券ID
  - voucher_t_price 价格
  - voucher_t_limit 最低消费价格
  - voucher_t_end_date 到期时间（Y-m-d）
- goods_eval_list[] 商品评价列表（最新的3个）
  - geval_scores 商品评分
  - geval_content 评价内容
  - geval_addtime 评价时间（时间戳）
  - geval_frommemberid 评价人id
  - geval_frommembername 评价人名称（匿名评价已经在名称上加*）
  - geval_explain 商家解释
  - geval_content_again 追加评价内容
  - geval_addtime_again 追加评价时间（时间戳）
  - geval_explain_again 商品对追加评价的解释
  - geval_addtime_date 评价时间(年月日)
  - geval_image_240[] 评价小图数组
  - geval_image_1024[] 评价大图数组
  - geval_addtime_again_date 追加评价时间(年月日)
  - geval_image_again_240[] 追评小图数组
  - geval_image_again_1024[] 追评大图数组
- goods_evaluate_info 商品评分
  - good 好评数量
  - normal 中评数量
  - bad 差评数量
  - all 全部数量
  - img 有图数量
  - good_percent 好评率
  - normal_percent 中评率
  - bad_percent 差评率
  - good_star 好评星星数
  - star_average 全部星星数
- goods_hair_info
  - content 运费信息
  - if_store 是否配送 true/false
  - if_store_cn 是否配送 有货/无货
  - area_name 地区描述，详细见 商品配送及运费信息 接口

#### 注意事项

- 价格
  - 有promotion_price则显示promotion_price，并且显示划掉的goods_price
  - 没有promotion_price则直接显示goods_price
- 购买数量
  - 普通商品验证是否超过库存goods_storage，如果有upper_limit需要验证是否超过该值
  - 虚拟商品验证是否超过库存goods_storage，同时需要验证是否超过virtual_limit
- 加入购物车按钮
  - cart为1时有加入购物车按钮
  - cart为0时没有加入购物车按钮只显示立即购买按钮

### 商品介绍信息

#### 调用接口(get)

      index.php?app=goods&feiwa=goods_body

#### 请求参数

- goods_id 商品编号

#### 返回数据

- html

### 商品配送及运费信息

#### 调用接口(get)

      index.php?app=goods&feiwa=calc

#### 请求参数

- goods_id 商品编号
- area_id 二级地区ID

#### 返回数据

- content 配送及运费信息
- if_store 是否有货[即是否支持配送],值true/false
- if_store_cn 是否配送 有货/无货
- area_name 完整地区内容，当传入area_id时，该值为为空字符串
- 当不传入area_id时，并且该店铺已经设置默认配置区域后，area_name为设置的完整区域内容，如果店铺未设置区，该值还是返回空

##### 返回数据示例

    {"code":200,"datas":{"content":"运费：5.00元","if_store_cn": "无货","if_store":false,"area_name":""}}
    {"code":200,"datas":{"content":"运费：5.00元","if_store_cn": "有货","if_store":true,"area_name":"内蒙古 呼和浩特市 和林格尔县"}}
    {"code":200,"datas":{"content":"免运费","if_store_cn": "有货","if_store":true,"area_name":""}}

### o2o商家分店地址列表

#### 调用接口(get)

      index.php?app=goods&feiwa=store_o2o_addr

#### 请求参数

- store_id
- lng 当前手机所在位置经度(wgs-84标准)
- lat 当前手机所在位置纬度(wgs-84标准)

#### 返回数据

- addr_list 地址列表
  - key ID
  - map_id ID
  - name_info 分店名
  - address_info 详细地址
  - phone_info 联系电话
  - bus_info 公交路线
  - city 市
  - district 区
  - lng 经度
  - lat 纬度
  - gcjlng 经度
  - gcjlat 纬度
  - distance 当前手机位置与店铺距离

### 商品评价列表

#### 调用接口(get)

      index.php?app=goods&feiwa=goods_evaluate

#### 请求参数

- goods_id 商品编号
- type 类型， 1好评、2中评、3差评、4有图 （可不填）、5追评
- page 每页数量
- curpage 当前页码

#### 返回数据

- goods_eval_list
  - geval_scores 商品评分
  - geval_content 评价内容
  - geval_addtime 评价时间（时间戳）
  - geval_frommemberid 评价人id
  - geval_frommembername 评价人名称（匿名评价已经在名称上加*）
  - geval_explain 商家解释
  - geval_content_again 追加评价内容
  - geval_addtime_again 追加评价时间
  - geval_explain_again 商品对追加评价的解释
  - member_avatar 会员头像url
  - geval_image_240 评价小图数组
  - geval_image_1024 评价大图数组
  - geval_image_again_240 追评小图数组
  - geval_image_again_1024 追评大图数组

### 登录

#### 调用接口(post)

      index.php?app=login

#### 请求参数

- username 用户名/手机/邮箱
- password 密码
- client 客户端类型(android wap ios wechat windows)

#### 返回数据

- username 用户名
- userid 用户编号
- key 登录令牌

### 第三方账号开关

#### 调用接口(get)

      index.php?app=connect&feiwa=get_state

#### 请求参数

- t 查询帐号类型，可为空

#### 返回数据

- 1或0 帐号类型存在时
- connect_qq 手机客户端的QQ互联
- connect_sn 手机客户端的新浪微博
- connect_wx 手机客户端的微信登录
- connect_sms_reg 手机注册
- connect_sms_lgn 手机登录
- connect_sms_psd 手机短信找回密码

### 获取短信动态码

#### 调用接口(get)

      index.php?app=connect&feiwa=get_sms_captcha

#### 请求参数

- sec_key 验证码标识
- sec_val 验证码值
- phone 手机号
- type 短信类型:1为注册,2为登录,3为找回密码

#### 返回数据

- sms_time 发短信间隔（单位为秒）

### 验证短信动态码

#### 调用接口(get)

      index.php?app=connect&feiwa=check_sms_captcha

#### 请求参数

- phone 手机号
- captcha 动态码
- type 短信类型:1为注册,2为登录,3为找回密码

#### 返回数据

- 1

### 手机注册

#### 调用接口(post)

      index.php?app=connect&feiwa=sms_register

#### 请求参数

- phone 手机号
- captcha 动态码
- password 密码
- client 客户端类型(android wap ios wechat windows)

#### 返回数据

- username 用户名
- userid 用户编号
- key 登录令牌

### 手机找回密码

#### 调用接口(post)

      index.php?app=connect&feiwa=find_password

#### 请求参数

- phone 手机号
- captcha 动态码
- password 密码
- client 客户端类型(android wap ios wechat windows)

#### 返回数据

- username 用户名
- userid 用户编号
- key 登录令牌

### 注册

#### 调用接口(post)

      index.php?app=login&feiwa=register

#### 请求参数

- username 用户名（6~20个字符，中文算一个字符）
- password 密码
- password_confirm 密码确认
- email 邮箱
- client 客户端类型(android wap ios wechat windows)

#### 返回数据

- username 用户名
- userid 用户编号
- key 登录令牌

### 注册协议

#### 调用接口

      index.php?app=document&feiwa=agreement

#### 返回数据

- doc_id 索引id
- doc_code 标识码
- doc_title 标题
- doc_content 内容
- doc_time 添加/修改时间

### 获取微信应用标识

#### 调用接口(get)

      index.php?app=connect&feiwa=get_wx_appid

#### 请求参数

- 无

#### 返回数据

- 应用标识字符串

### 微信登录及注册

#### 调用接口(get)

      index.php?app=connect&feiwa=get_wx_info

#### 请求参数

    使用微信原生sdk需要提交code，使用友盟sdk需要提交access_token和openid

- code 微信返回的授权临时票据code 使用微信sdk时提交
- access_token 使用友盟时需要提交
- openid 使用友盟时需要提交
- client 客户端类型(android wap ios wechat windows)

#### 返回数据

- username 用户名
- userid 用户编号
- key 登录令牌
- password 系统自动生成的随机密码（第一次注册出现，登录时没有）

### 获取新浪微博应用标识

#### 调用接口(get)

      index.php?app=connect&feiwa=get_sina_appid

#### 请求参数

- 无

#### 返回数据

- 应用标识字符串

### 获取新浪微博授权

#### 调用接口(get)

      index.php?app=connect&feiwa=get_sina_oauth2

#### 请求参数

- 无

#### 返回数据

- 访问页面后自动跳转到新浪微博登录

### 新浪微博登录及注册

#### 调用接口(get)

      index.php?app=connect&feiwa=get_sina_info

#### 请求参数

- code 新浪返回的授权临时票据code（wap访问时出现，客户端时没有）
- client 客户端类型(android wap ios wechat windows)
- accessToken 新浪返回的认证口令（客户端访问时出现，wap时没有）
- userID 新浪返回的用户ID（客户端访问时出现，wap时没有）

#### 返回数据

- wap访问时自动跳转到“tmpl/member/member.html?username=参数&key=参数”，客户端时返回下面的数据
- username 用户名
- userid 用户编号
- key 登录令牌
- password 系统自动生成的随机密码（注册时出现，登录时没有）

### 获取QQ应用标识

#### 调用接口(get)

      index.php?app=connect&feiwa=get_qq_appid

#### 请求参数

- 无

#### 返回数据

- 应用标识字符串

### 获取QQ授权

#### 调用接口(get)

      index.php?app=connect&feiwa=get_qq_oauth2

#### 请求参数

- 无

#### 返回数据

- 访问页面后自动跳转到QQ登录(wap调用)

### QQ登录及注册

#### 调用接口(get)

      index.php?app=connect&feiwa=get_qq_info

#### 请求参数

- code wap版使用的授权临时票据code
- token 客户端版用的使用Implicit_Grant方式获取的token（参考：移动端应用）
- client 客户端类型(android wap ios wechat windows)
- open_id 用户身份的标识
- nickname 用户在QQ空间的昵称
- avatar QQ空间头像URL

#### 返回数据

- wap访问时自动跳转到“tmpl/member/member.html?username=参数&key=参数”，客户端时返回下面的数据
- username 用户名
- userid 用户编号
- key 登录令牌
- password 系统自动生成的随机密码（注册时出现，登录时没有）

### 地区列表

#### 调用接口(get)

      index.php?app=area&feiwa=area_list

#### 请求参数

- area_id 地区编号(为空时默认返回一级分类)

#### 返回数据

- area_id 地区编号
- area_name 地区名称

### Android版本检查

#### 调用接口(get)

    index.php?app=index&feiwa=apk_version

#### 请求参数

- 无

#### 返回数据

- version 当前版本号，版本号未设置时返回空字符串
- url apk下载地址

### 意见反馈

#### 调用接口(post)

    index.php?app=member_feedback&feiwa=feedback_add

#### 请求参数

- key 当前登录令牌
- feedback 反馈内容

#### 返回数据

- '1'

### 推荐品牌列表

#### 调用接口

      index.php?app=brand&feiwa=recommend_list

#### 请求参数

- 无

#### 返回数据

- brand_list
  - brand_id 品牌id
  - brand_name 品牌名称
  - brand_pic 品牌图片

### 默认搜索关键词列表

#### 调用接口

      index.php?app=index&feiwa=search_key_list

#### 请求参数

- 无

#### 返回数据

- 返回名为“list”的数组，没有key，只有value

### 热门关键词

#### 调用接口

      index.php?app=index&feiwa=search_hot_info

#### 请求参数

- 无

#### 返回数据

- 返回名为“hot_key”的数组，name下标为显示词，value下标为实际参于搜索词，每次随机返回一个热门词

#### 示例

      {"code":200,"datas":{"hot_info":{"name":"61儿童节，童装5折狂甩","value":"童装"}}}

## 买家

### 注销

#### 调用接口(post)

      index.php?app=logout

#### 请求参数

- username 用户名
- key 当前登录令牌
- client 客户端类型(android wap ios wechat windows)

#### 返回数据

- '1'

### 我的商城

#### 调用接口(post)

      index.php?app=member_index

#### 请求参数

- key 当前登录令牌

#### 返回数据

- username 用户名
- avatar 用户头像
- level_name 会员等级
- favorites_store 收藏店铺数量
- favorites_goods 收藏商品数量
- order_nopay_count 待付款订单数量
- order_noreceipt_count 待发货订单数量
- order_notakes_count 待自提订单数量
- order_noeval_count 待评价订单数量
- return 退快/退货中的订单数量

### 我的资产

#### 调用接口(get)

      index.php?app=member_index&feiwa=my_asset

#### 请求参数

- key 当前登录令牌
- fields 需要返回的字段，例如point,predepoit,available_rc_balance

#### 返回数据

- point 积分
- predepoit 预存款
- available_rc_balance 充值卡余额
- redpacket 红包数量
- voucher 代金券数量

### 收藏列表

#### 调用接口(post)

      index.php?app=member_favorites&feiwa=favorites_list

#### 请求参数

- key 当前登录令牌

#### 返回数据

- goods_name 商品名称
- goods_image_url 商品图片地址
- goods_price 商品价格
- fav_id 收藏编号

### 收藏商品详情

#### 调用接口(post)

      index.php?app=member_favorites&feiwa=favorites_info

#### 请求参数

- key 当前登录令牌
- fav_id 商品ID

#### 返回数据

- log_id 收藏自增ID
- member_id 会员编号
- member_name 会员名称
- goods_id 商品ID
- fav_type 收藏类型
- fav_time 收藏时间
- store_id 店铺ID
- store_name 店铺名称
- sc_id 店铺分类ID
- goods_name 商品名称
- goods_image_url 商品图片地址
- gc_id 商品分类ID
- log_price 商品收藏时价格
- sell_price 商品实际价格
- goods_price 商品价格

### 收藏添加

#### 调用接口(post)

      index.php?app=member_favorites&feiwa=favorites_add

#### 请求参数

- goods_id 商品编号
- key 当前登录令牌

#### 返回数据

- '1'

### 收藏删除

#### 调用接口(post)

      index.php?app=member_favorites&feiwa=favorites_del

#### 请求参数

- fav_id 收藏编号
- key 当前登录令牌

#### 返回数据

- '1'

### 地址列表

#### 调用接口(post)

      index.php?app=member_address&feiwa=address_list

#### 请求参数

- key 当前登录令牌

#### 返回数据

- address_list
  - city_id 城市编号
  - area_id 地区编号
  - area_info 地址
  - address 详细地址
  - tel_phone 固定电话机
  - mob_phone 手机

### 地址详细信息

#### 调用接口(post)

      index.php?app=member_address&feiwa=address_info

#### 请求参数

- key 当前登录令牌
- address_id 地址编号

#### 返回数据

- area_info 地址
- address 详细地址
- tel_phone 固定电话机
- mob_phone 手机

### 地址删除

#### 调用接口(post)

      index.php?app=member_address&feiwa=address_del

#### 请求参数

- key 当前登录令牌
- address_id 地址编号

#### 返回数据

- '1'

### 地址添加

#### 调用接口(post)

      index.php?app=member_address&feiwa=address_add

#### 请求参数

- key 当前登录令牌
- true_name 姓名
- city_id 城市编号(地址联动第二级)
- area_id 地区编号(地址联动最后一级)
- area_info 地区信息，例：天津 天津市 红桥区
- address 地址信息，例：水游城8层
- tel_phone 电话号码
- mob_phone 手机
- is_default 是否为默认收货地址 1是 0否

#### 返回数据

- address_id

### 地址编辑

#### 调用接口(post)

      index.php?app=member_address&feiwa=address_edit

#### 请求参数

- key 当前登录令牌
- address_id 地址编号
- true_name 姓名
- city_id 城市编号(地址联动第二级)
- area_id 地区编号(地址联动最后一级)
- area_info 地区信息，例：天津 天津市 红桥区
- address 地址信息，例：水游城8层
- tel_phone 电话号码
- mob_phone 手机
- is_default 是否为默认收货地址 1是 0否

#### 返回数据

- '1'

### 订单列表

#### 调用接口(post)

      index.php?app=member_order&feiwa=order_list

#### 请求参数

- key 当前登录令牌
- state_type 订单状态 state_new待付款，state_send待收货，state_notakes待自提，state_noeval待评价
- order_key 搜索项 订单编号(精确查找) 或 商品名称(模糊查找)

#### 返回数据

- order_group_list
  - order_list 订单列表
    - order_id 订单id
    - order_sn 订单sn
    - store_name 店铺名称
    - goods_amount 商品总价
    - order_amount 订单总价
    - pd_amount 预存款支付总价
    - shipping_fee 运费
    - state_desc 状态文字
    - payment_name 支付方式文字
    - if_cancel 是否显示取消按钮 true/false
    - if_receive 是否显示确认收货按钮 true/false
    - if_lock 是否显示锁定中状态 true/false
    - if_deliver 是否显示查看物流按钮 true/false
    - if_evaluation 是否显示评价按钮 true/false
    - if_evaluation_again 是否显示追加评价按钮 true/false
    - if_refund_cancel 是否显示退款按钮 true/false
    - extend_order_goods 订单商品列表
      - goods_name 商品名称
      - goods_price 商品价格
      - goods_num 商品购买数量
      - goods_image_url 商品图片地址
      - refund 是否显示“退款/退货” 按钮 true/false
    - zengpin_list 赠品列表
      - goods_name 商品名称
      - goods_price 商品价格
      - goods_num 商品购买数量
      - goods_image_url 商品图片地址
      - refund 是否显示“退款/退货” 按钮 true/false
  - pay_amount 支付总额，该字段存在且大于0时显示支付按钮
  - add_time 订单提交时间
  - pay_sn 支付编号

#### 订单状态

- 0-已取消
- 10-未支付
- 20-已支付
- 30-已发货
- 40-交易成功

### 订单详情

#### 调用接口(get)

      index.php?app=member_order&feiwa=order_info

#### 请求参数

- key 当前登录令牌
- order_id 订单ID

#### 返回数据

- order_info
  - order_id 订单ID
  - order_sn 订单编号
  - store_id 店铺ID
  - store_name 店铺名
  - add_time 下单时间
  - payment_time 付款时间
  - shipping_time 发货时间
  - finnshed_time 完成时间
  - order_amount 订单总金额
  - shipping_fee 运费
  - state_desc 订单状态
  - order_message 买家留言
  - reciver_phone 收货人电话
  - reciver_name 收货人姓名
  - reciver_addr 收货人地址
  - invoice 发票信息
  - if_buyer_cancel 是否可以取消订单 true/false
  - if_refund_cancel 是否允许订单退款(全部退款) true/false
  - if_receive 是否允许收货 true/false
  - if_evaluation 是否允许评价 true/false
  - goods_list 商品列表
    - rec_id 订单商品编号
    - goods_id 商品ID
    - goods_name 商品名称
    - goods_price 商品价格
    - goods_num 购买数量
    - goods_spec 规格
    - image_url 商品图URL
    - refund 是否允许退款退货 1/0
  - zengpin_list 订单列表
    - goods_name 商品名
    - goods_num 购买数量

### 订单取消(未付款)

#### 调用接口(post)

      index.php?app=member_order&feiwa=order_cancel

#### 请求参数

- key 当前登录令牌
- order_id 订单编号

#### 返回数据

- '1'

### 订单删除

#### 调用接口(post)

      index.php?app=member_order&feiwa=order_delete

#### 请求参数

- key 当前登录令牌
- order_id 订单编号

#### 返回数据

- '1'

### 订单确认收货

#### 调用接口(post)

      index.php?app=member_order&feiwa=order_receive

#### 请求参数

- key 当前登录令牌
- order_id 订单编号

#### 返回数据

- '1'

### 订单物流信息

#### 调用接口(post)

      index.php?app=member_order&feiwa=search_deliver

#### 请求参数

- key 当前登录令牌
- order_id 订单编号

#### 返回数据

- express_name 物流公司名称
- shipping_code 物流编号
- deliver_info 物流信息

### 订单物流信息-返回最新的一条信息

#### 调用接口(post)

      index.php?app=member_order&feiwa=get_current_deliver

#### 请求参数

- key 当前登录令牌
- order_id 订单编号

#### 返回数据

- deliver_info
  - context 物流描述
  - time 发生时间

### 购物车列表

#### 调用接口(post)

      index.php?app=member_cart&feiwa=cart_list

#### 请求参数

- key 当前登录令牌

#### 返回数据

- cart_list[]
  - store_id 店铺编号
  - store_name 店铺名称
  - goods[] 购物车商品
    - cart_id 购物车编号
    - buyer_id 买家member_id
    - goods_id 商品编号
    - goods_name 商品名称
    - goods_price 商品价格
    - goods_num 购买数量
    - goods_image_url 图片地址
    - goods_total 商品总价
    - gift_list[] 赠品(没有不出现)
      - gift_goodsname 赠品名称
      - goods_image_url 赠品图片
      - gift_amount 赠送数量
  - voucher[] 代金券（没有不出现）
    - voucher_t_id 代金券模板id
    - voucher_t_price 代金券面额
    - voucher_t_limit 最低消费金额
    - voucher_t_end_date 过期时间
  - mansong[] 满即送规则（没有不出现）
    - desc 规则内容
    - goods_name 商品名
    - url 图片url地址
  - free_freight 免运费规格（没有不出现）
- sum 购物车总价
- cart_count 购物车商品数量

### 购物车添加

#### 调用接口(post)

      index.php?app=member_cart&feiwa=cart_add

#### 请求参数

- key 当前登录令牌
- goods_id 商品编号
- quantity 购买数量

#### 返回数据

- '1'

### 购物车批量添加

#### 调用接口(post)

      index.php?app=member_cart&feiwa=cart_batchadd

#### 请求参数

- key 当前登录令牌
- cartlist 新增购物列表，数据格式为goods_id1,num1|goods_id2,num2

#### 操作成功

    //code返回code为200，datas返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回code为400，error内为错误信息
    {"code":400,"datas":{"error":"参数错误"}}

### 购物车删除

#### 调用接口(post)

      index.php?app=member_cart&feiwa=cart_del

#### 请求参数

- key 当前登录令牌
- cart_id 购物车编号

#### 返回数据

- '1'

### 购物车修改数量

#### 调用接口(post)

      index.php?app=member_cart&feiwa=cart_edit_quantity

#### 请求参数

- key 当前登录令牌
- cart_id 购物车编号
- quantity 新的购买数量

#### 返回数据

- quantity 购买数量
- goods_price 商品价格
- total_price 商品总价

### 查询购物车商品数量

#### 调用接口

      index.php?app=member_cart&feiwa=cart_count

#### 请求参数

- key 当前登录令牌

#### 返回数据

- cart_count 购物车数量

### 发票列表

#### 调用接口(post)

      index.php?app=member_invoice&feiwa=invoice_list

#### 请求参数

- key 当前登录令牌

#### 返回数据

- invoice_list
  - inv_id 发票编号
  - inv_title 发票抬头
  - inv_content 发票内容

### 发票添加

#### 调用接口(post)

      index.php?app=member_invoice&feiwa=invoice_add

#### 请求参数

- key 当前登录令牌
- inv_title_select 发票类型，可选值：person(个人) company(单位)
- inv_title 发票抬头(inv_title_select为company时需要提交)
- inv_content 发票内容，可通过invoice_content_list接口获取可选值列表

#### 返回数据

- inv_id 发票编号

### 发票删除

#### 调用接口(post)

      index.php?app=member_invoice&feiwa=invoice_del

#### 请求参数

- key 当前登录令牌
- inv_id 发票编号

#### 返回数据

- '1'

### 发票内容列表

#### 调用接口(post)

      index.php?app=member_invoice&feiwa=invoice_content_list

#### 请求参数

- key 当前登录令牌

#### 返回数据

- invoice_content_list

### 购买第一步

#### 调用接口(post)

      index.php?app=member_buy&feiwa=buy_step1

#### 请求参数

- key 当前登录令牌
- cart_id 购买参数
- ifcart 购物车购买标志 1
- address_id 收货地址id(收货地址表中的自增ID，不是某个地区ID)

##### cart_id说明

    立即购买： 第一个数字为商品编号，第二个数字为购买数量，用竖线分割。例：232|1
    购物车购买：第一个数字为购物车编号，第二个数字为购买数量，用竖线分割。多组用半角逗号分割，例：232|1,110|2 232商品购买1个，110商品购买2个

#### 返回数据

- ifcart 购物车购买标志 1
- store_cart_list 购物车列表 店铺编号为下标的数组
  - goods_list 商品列表
    - goods_num 购买数量
    - goods_id 商品编号
    - goods_commonid 商品通用编号
    - store_id 店铺编号
    - goods_name 商品名称
    - goods_price 商品价格
    - goods_image_url 商品图片
    - transport_id 运费模板编号
    - goods_freight 运费
    - goods_storage 库存
    - is_fcode 是否为F码商品 1是0否
    - state 商品是否有效 true
    - storage_state
    - cart_id 购物车编号
    - bl_id 组合销售编号
    - promotions_id
    - ifxianshi
    - premiums 赠品标志 true
    - goods_total 总价
  - store_goods_total 店铺商品总价 店铺编号为下标的数组
  - store_mansong_rule_list 满送规则列表 店铺编号为下标的数组
  - store_vouche_list 店铺代金券列表 数组下标是voucher_t_id
  - store_voucher_info 店铺代金券信息(只返回一个代金券信息)，无代金券时返回空数组
  - freight 0-免运费 1-需要计算运费
  - freight_message 免运费时的说明
  - store_name 店铺名称
- freight_hash 运费hash，选择地区时作为参数提交
- address_info 收货地址信息
- ifshow_offpay 支持货到付款时为true
- vat_hash 发票信息hash
- inv_info 发票信息
- available_predeposit 可用预存款
- rpt_list 平台红包列表[返回所有可用平台红包，地区变化后运费会变化，订单总价会变化，红包会有变化]
  - rpacket_price 红包面额
  - rpacket_limit 满足这个值后才可以使用红包，当为0时表示使用无限制
  - rpacket_t_id 红包ID
  - desc 红包描述[例：300元红包 有效期至 2015-06-09 消费满20000.00可用]
- zk_list 会员享受折扣描述 数组格式，下标为店铺ID，值为折扣内容描述
- rpt_info 平台红包（系统返回一个红包）
  - rpacket_price 红包面额
  - rpacket_limit 满足这个值后才可以使用红包，当为0时表示使用无限制
  - rpacket_t_id 红包ID
- order_amount 订单总金额(计算代金券，运费，红包之后的金额)
- address_api 只有当传入address_id时，才会返回,返回内容与更换收货地址接口返回的内容一致
- store_final_total_list 每个店铺的订单金额（计算代金券，运费后的金额）

##### rpt_list 红包展示说明

    值用竖线分割，第一个数字为红包ID，第二个数字为红包面额。例：3|100
    网页端展示示例：
    <select id="rpt" name="rpt">
      <option value="|0.00">选择平台红包</option>
      <option value="5|300">300元红包 有效期至 2015-06-09 消费满20000.00可用</option>
    </select>

### 更换收货地址

#### 调用接口(post)

      index.php?app=member_buy&feiwa=change_address

#### 请求参数

- key 当前登录令牌
- freight_hash 运费hash，第一步返回结果里有直接提交
- city_id 城市编号
- area_id 地区编号

#### 返回数据

- content 运费列表，以店铺编号为下标数组，值为运费
- allow_offpay 是否允许货到付款 1-允许 0-不允许
- offpay_hash 货到付款hash
- offpay_hash_batch 店铺是否支持货到付款hash
- no_send_tpl_ids 不支持发货的配送区域模板ID列表，值为配送区域模板ID

### 验证支付密码

#### 调用接口(post)

      index.php?app=member_buy&feiwa=check_password

#### 请求参数

- key 当前登录令牌
- password 用户支付密码

#### 返回数据

- '1'

### 购买第二步

#### 调用接口(post)

      index.php?app=member_buy&feiwa=buy_step2

#### 请求参数

- key 当前登录令牌
- ifcart 购物车购买标志 1
- cart_id 购买参数
- address_id 收货地址编号
- vat_hash 发票信息hash，第一步接口提供
- offpay_hash 是否支持货到付款hash，通过更换收货地址接口获得
- offpay_hash_batch 店铺是否支持货到付款hash
- pay_name 付款方式，可选值 online(线上付款) offline(货到付款)
- invoice_id 发票信息编号
- voucher 代金券，内容以竖线分割 voucher_t_id|store_id|voucher_price，多个店铺用逗号分割，例：10|2|10,1|3|10
- pd_pay 是否使用预存款支付 1-使用 0-不使用
- password 用户支付密码，启动预存款支付时需要提交
- fcode F码购买时需提交
- rcb_pay 是否使用充值卡 1-使用 0-不使用
- rpt 红包
- pay_message 留言内容，说明：店铺ID + “|” + 留言内容 + “,”。

##### cart_id说明

    立即购买： 第一个数字为商品编号，第二个数字为购买数量，用竖线分割。例：232|1
    购物车购买：第一个数字为购物车编号，第二个数字为购买数量，用竖线分割。多组用半角逗号分割，例：232|1,110|2 232商品购买1个，110商品购买2个

##### rpt说明

    内容用竖线分割，第一个数字为红包ID，第二个数字为红包面额。例：3|100

#### 返回数据

- pay_sn 支付编号

### 下单第二步-F码验证

#### 调用接口(post)

      index.php?app=member_buy&feiwa=check_fcode

#### 请求参数

- key 当前登录令牌
- goods_id 商品ID
- fcode F码

#### 返回数据

- 验证成功：code为200，datas 为 1
- 验证失败: code为400，error内为错误信息

### 下单第二步-支付密码验证

#### 调用接口(post)

      index.php?app=member_buy&feiwa=check_pd_pwd

#### 请求参数

- key 当前登录令牌
- password 支付密码

#### 返回数据

- 验证成功：code为200，datas 为 1
- 验证失败: code为400，error内为错误信息

### 下单第三步-选择支付方式

#### 调用接口(post)

      index.php?app=member_buy&feiwa=pay

#### 请求参数

- key 当前登录令牌
- pay_sn 支付单号

#### 返回数据

- pay_info
  - pay_amount 未支付金额
  - member_available_pd 可用预存款
  - member_available_rcb 可用充值卡
  - member_paypwd 是否设置了支付密码 true/false
  - pay_sn 支付单号
  - payed_amount 已经支付(预存款+充值卡)的金额，如果该值大于0，则不再需要选择使用预存款或充值卡。
  - payment_list
    - payment_name 支付方式名称
    - payment_code 支付方式代码

### 下单第四步-选择完支付方式跳往第三方支付平台

#### 调用接口(get)

      index.php?app=member_payment&feiwa=pay_new

#### 请求参数

- key 当前登录令牌
- pay_sn 支付单号
- password 支付密码
- rcb_pay 是否使用充值卡 1/0
- pd_pay 是否使用预存款 1/0
- payment_code 支付方式代码

#### 返回数据

### 可用支付方式列表

#### 调用接口(post)

    index.php?app=member_payment&feiwa=payment_list

#### 请求参数

- key 当前登陆令牌

#### 返回数据

- payment_list 可用支付方式列表
  - wxpay-微信支付 仅原生应用使用
  - alipay-支付宝移动支付 原生和wap都可以使用
  - wxpay_jsapi-微信支付JSAPI 仅wap使用
  - alipay_native-支付宝原生支付 仅原生应用使用

### 支付

#### 调用接口(get)

      index.php?app=member_payment&feiwa=pay

#### 请求参数

- key 当前登录令牌
- pay_sn 支付编号

### 获取微信APP支付信息

#### 调用接口(post)

      index.php?app=member_payment&feiwa=wx_app_pay

#### 请求参数

- key 当前登录令牌
- pay_sn 支付单编号

#### 返回数据

- appid 微信开放平台appid
- noncestr 随机字符串
- package 支付内容
- partnerid 财付通id
- prepayid 微信预支付编号
- sign 签名
- timestamp 时间戳

### 获取微信APP支付信息(v3)

#### 调用接口(post)

      index.php?app=member_payment&feiwa=wx_app_pay3

#### 请求参数

- key 当前登录令牌
- pay_sn 支付单编号

#### 返回数据

- appid 微信开放平台appid
- noncestr 随机字符串
- package 支付内容
- partnerid 财付通id
- prepayid 微信预支付编号
- sign 签名
- timestamp 时间戳

### 手机支付宝原生支付接口 实物

#### 调用接口(post)

      index.php?app=member_payment&feiwa=alipay_native_pay

#### 请求参数

- key 当前登录令牌
- pay_sn 支付单编号

#### 返回数据

- signStr 待签名字符串及签名后的组成的字符串(已经进行了urlencode)，手机端将些内容原样提交到支付宝即可

### 手机支付宝原生支付接口 虚拟

#### 调用接口(post)

      index.php?app=member_payment&feiwa=alipay_native_vr_pay

#### 请求参数

- key 当前登录令牌
- pay_sn 支付单编号

#### 返回数据

- signStr 待签名字符串及签名后的组成的字符串(已经进行了urlencode)，手机端将些内容原样提交到支付宝即可

### 买家代金券列表

#### 调用接口(post)

    index.php?app=member_voucher&feiwa=voucher_list

#### 请求参数

- key 当前登录令牌
- voucher_state 代金券状态(1-未使用 2-已使用 3-已过期)

#### 返回数据

- voucher_list 代金券列表
  - voucher_id 代金券编号
  - voucher_code 代金券编码
  - voucher_title 代金券标题
  - voucher_desc 代金券描述
  - voucher_start_date 代金券开始时间
  - voucher_end_date 代金券过期时间
  - voucher_start_date_text 代金券开始时间文本
  - voucher_end_date_text 代金券结束时间文本
  - voucher_price 代金券面额
  - voucher_limit 代金券使用限额
  - voucher_state 代金券状态编号
  - voucher_order_id 使用代金券的订单编号
  - voucher_store_id 店铺编号
  - voucher_t_customimg 代金券图片
  - voucher_state_text 代金券状态文字
  - store_name 店铺名称
  - store_id 店铺编号
  - store_domain 店铺域名
  - is_own_mall 是否自营店铺
  - store_logo 店铺logo
  - store_logo_url 店铺logo路径
  - store_avatar 店铺头像
  - store_avatar_url 店铺头像路径

### 卡密领取店铺代金券

#### 调用接口(post)

    index.php?app=member_voucher&feiwa=voucher_pwex

#### 请求参数

- key 当前登录令牌
- pwd_code 卡密
- codekey 该接口需要验证码验证，该参数为验证码标识
- captcha 该接口需要验证码验证，该参数为验证码值

#### 操作成功

    //code返回code为200，datas返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回code为400，error内为错误信息
    {"code":400,"datas":{"error":"参数错误"}}

### 免费领取店铺代金券

#### 调用接口(post)

    index.php?app=member_voucher&feiwa=voucher_freeex

#### 请求参数

- key 当前登录令牌
- tid 代金券模板ID

#### 操作成功

    //code返回code为200，datas返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回code为400，error内为错误信息
    {"code":400,"datas":{"error":"参数错误"}}

### 图片上传（评价、追评晒图）

#### 调用接口(post)

    index.php?app=sns_album&feiwa=file_upload

#### 请求参数

- key 当前登录令牌
- file $_FILES数据

#### 返回数据

- file_id 字段id
- file_name 文件名称
- origin_file_name 原文件名称
- file_url 图片路径

### 评价商品/店铺（实物）

#### 调用接口

    index.php?app=member_evaluate&feiwa=index

#### 请求参数

- key 当前登录令牌
- order_id 订单id

#### 返回数据

- store_info 店铺信息
  - store_id 店铺id
  - store_name 店铺名称
  - is_own_mall 是否为平台店铺，1是 0否
- order_goods[] 订单商品信息
  - rec_id 索引id
  - order_id 订单id
  - goods_id 商品id
  - goods_name 商品名称
  - goods_price 商品价格
  - goods_num 购买数量
  - goods_image 商品图片
  - goods_pay_price 实际支付价格
  - store_id 店铺id
  - buyer_id 买家id
  - goods_type 商品类型 1默认2团购商品3限时折扣商品4组合套装5赠品8加价购活动商品9加价购换购商品
  - promotions_id 促销活动ID（团购ID/限时折扣ID/优惠套装ID）与goods_type搭配使用
  - commis_rate 佣金比例
  - gc_id 商品分类（最后一级）
  - goods_spec 商品规格
  - goods_contractid 商品开启的消费者保障服务id
  - goods_image_url 商品图片路径

### 评价商品/店铺保存（实物）

#### 调用接口(post)

    index.php?app=member_evaluate&feiwa=save

#### 请求参数

- key 当前登录令牌
- order_id 订单id
- goods 评价商品
  - 0 评价商品/店铺接口的order_goods的rec_id
    - score 商品评分1~5
    - comment 评论内容，不超过150个字符
    - anony 是否匿名评价，1为匿名/0为不匿名
    - evaluate_image[] 晒图数组，最多5个
- store_desccredit 宝贝与描述相符（只有三方店铺需要填写，即is_own_mall=0）
- store_servicecredit 卖家的服务态度（只有三方店铺需要填写，即is_own_mall=0）
- store_deliverycredit 卖家的发货速度（只有三方店铺需要填写，即is_own_mall=0）

#### 返回数据

- '1'

### 追加评价（实物）

#### 调用接口

    index.php?app=member_evaluate&feiwa=again

#### 请求参数

- key 当前登录令牌
- order_id 订单id

#### 返回数据

- store_info 店铺信息
  - store_id 店铺id
  - store_name 店铺名称
- evaluate_goods[] 订单商品信息
  - geval_id
  - geval_orderid 订单id
  - geval_orderno 订单编号
  - geval_ordergoodsid 订单商品表编号
  - geval_goodsid 商品id
  - geval_goodsname 商品名称
  - geval_goodsprice 商品价格
  - geval_goodsimage 商品图片
  - geval_scores 商品评分
  - geval_content 评价内容
  - geval_isanonymous 是否匿名，1是/0否
  - geval_addtime 评价时间
  - geval_storeid 店铺id
  - geval_storename 店铺名称
  - geval_frommemberid 评价人编号
  - geval_frommembername 评价人名称
  - geval_explain 解释内容
  - geval_image 晒单图片
  - geval_content_again 追加评价内容
  - geval_addtime_again 追加评价时间
  - geval_image_again 追加评价图片
  - geval_explain_again 追加评价解释

### 追加评价保存（实物）

#### 调用接口(post)

    index.php?app=member_evaluate&feiwa=save_again

#### 请求参数

- key 当前登录令牌
- order_id 订单id
- goods 评价商品
  - 0 评价商品/店铺接口的evaluate_goods的geval_id
    - comment 评论内容，不超过150个字符
    - evaluate_image[] 晒图数组，最多5个

#### 返回数据

- '1'

### 商品浏览记录列表

#### 调用接口(post)

    index.php?app=member_goodsbrowse&feiwa=browse_list

#### 请求参数

- key 当前登录令牌

#### 返回数据

- goodsbrowse_list 浏览历史列表
  - goods_id 商品编号
  - goods_name 商品名称
  - goods_promotion_price 促销价格
  - goods_promotion_type 促销类型
  - goods_marketprice 商品市场价格
  - goods_image 商品图片
  - goods_image_url 商品图片路径
  - store_id 商品所属店铺ID
  - gc_id 所属分类ID
  - gc_id_1 所属商品一级分类ID
  - gc_id_2 所属商品二级分类ID
  - gc_id_3 所属商品三级分类ID
  - member_id 会员ID
  - browsetime 浏览时间戳
  - browsetime_day 浏览日期文本
  - browsetime_text 浏览时间文本

### 商品浏览记录清空

#### 调用接口

    index.php?app=member_goodsbrowse&feiwa=browse_clearall

#### 请求参数

- key 当前登录令牌

#### 操作成功

    //code返回code为200，datas返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回code为400，error内为错误信息
    {"code":400,"datas":{"error":"清空失败"}}

### 我的红包记录列表

#### 调用接口(post)

    index.php?app=member_redpacket&feiwa=redpacket_list

#### 请求参数

- key 当前登录令牌
- rp_state 记录状态 可选参数为空则为全部记录，'unused'未使用，'used'已使用，'expire'已过期

#### 返回数据

- redpacket_list 红包列表
  - rpacket_id 红包编号
  - rpacket_code 红包编码
  - rpacket_t_id 红包模版编号
  - rpacket_title 红包标题
  - rpacket_desc 红包描述
  - rpacket_start_date 红包有效期开始时间
  - rpacket_end_date 红包有效期结束时间
  - rpacket_price 红包面额
  - rpacket_limit 红包使用时的订单限额
  - rpacket_state 红包状态
  - rpacket_active_date 红包发放日期
  - rpacket_owner_id 红包所有者id
  - rpacket_owner_name 红包所有者名称
  - rpacket_order_id 使用该红包的订单支付单号
  - rpacket_customimg 红包自定义图片
  - rpacket_customimg_url 红包自定义图片url
  - rpacket_state_text 红包状态文本
  - rpacket_state_key 红包状态标识

### 卡密领取红包

#### 调用接口(post)

    index.php?app=member_redpacket&feiwa=rp_pwex

#### 请求参数

- key 当前登录令牌
- pwd_code 卡密
- codekey 该接口需要验证码验证，该参数为验证码标识
- captcha 该接口需要验证码验证，该参数为验证码值

#### 操作成功

    //code返回code为200，datas返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回code为400，error内为错误信息
    {"code":400,"datas":{"error":"参数错误"}}

### 积分日志记录

#### 调用接口(post)

    index.php?app=member_points&feiwa=pointslog

#### 请求参数

- key 当前登录令牌

#### 返回数据

- log_list 积分日志列表
  - pl_id 日志编号
  - pl_memberid 会员编号
  - pl_membername 会员名
  - pl_adminid 管理员ID
  - pl_adminname 管理员名称
  - pl_points 积分
  - pl_addtime 添加时间
  - addtimetext 添加时间格式化字符串
  - pl_desc 操作描述
  - pl_stage 操作阶段标识
  - stagetext 操作阶段文字

### 预存款日志记录

#### 调用接口(get)

    index.php?app=member_fund&feiwa=predepositlog

#### 请求参数

- key 当前登录令牌

#### 返回数据

- list 预存款日志列表
  - lg_id 日志编号
  - lg_member_id 会员编号
  - lg_member_name 会员名称
  - lg_admin_name 管理员名称
  - lg_type 操作类型
  - lg_av_amount 可用金额变更值
  - lg_freeze_amount 冻结金额变更值
  - lg_add_time 添加时间
  - lg_add_time_text 添加时间文本
  - lg_desc 描述

### 预存款充值明细

#### 调用接口(get)

    index.php?app=member_fund&feiwa=pdrechargelist

#### 请求参数

- key 当前登录令牌

#### 返回数据

- list 预存款充值列表
  - pdr_id 自增编号
  - pdr_sn 充值记录编号
  - pdr_member_id 会员编号
  - pdr_member_name 会员名称
  - pdr_amount 充值金额
  - pdr_payment_code 支付方式标识
  - pdr_payment_name 支付方式名称
  - pdr_trade_sn 第三方支付接口交易号
  - pdr_add_time 添加时间
  - pdr_add_time_text 添加时间文本
  - pdr_payment_state 支付状态 0未支付1支付
  - pdr_payment_state_text 支付状态文本
  - pdr_payment_time 支付时间
  - pdr_admin 管理员名

### 预存款提现记录

#### 调用接口(get)

    index.php?app=member_fund&feiwa=pdcashlist

#### 请求参数

- key 当前登录令牌

#### 返回数据

- list 预存款提现记录列表
  - pdc_id 自增编号
  - pdc_sn 记录编号
  - pdc_member_id 会员编号
  - pdc_member_name 会员名称
  - pdc_amount 提现金额
  - pdc_bank_name 收款银行
  - pdc_bank_no 收款账号
  - pdc_bank_user 开户人姓名
  - pdc_add_time 添加时间
  - pdc_add_time_text 添加时间文本
  - pdc_payment_time 付款时间
  - pdc_payment_time_text 付款时间文本
  - pdc_payment_state 提现支付状态 0默认1支付完成
  - pdc_payment_state_text 提现支付状态文本
  - pdc_payment_admin 支付管理员

### 预存款提现详情

#### 调用接口(get)

    index.php?app=member_fund&feiwa=pdcashinfo

#### 请求参数

- key 当前登录令牌
- pdc_id 提现记录ID

#### 返回数据

- info 预存款提现记录详情
  - pdc_id 自增编号
  - pdc_sn 记录编号
  - pdc_member_id 会员编号
  - pdc_member_name 会员名称
  - pdc_amount 提现金额
  - pdc_bank_name 收款银行
  - pdc_bank_no 收款账号
  - pdc_bank_user 开户人姓名
  - pdc_add_time 添加时间
  - pdc_add_time_text 添加时间文本
  - pdc_payment_time 付款时间
  - pdc_payment_time_text 付款时间文本
  - pdc_payment_state 提现支付状态 0默认1支付完成
  - pdc_payment_state_text 提现支付状态文本
  - pdc_payment_admin 支付管理员

### 充值卡日志记录

#### 调用接口(get)

    index.php?app=member_fund&feiwa=rcblog

#### 请求参数

- key 当前登录令牌

#### 返回数据

- log_list 预存款日志列表
  - id 日志编号
  - member_id 会员编号
  - member_name 会员名称
  - type 操作类型
  - add_time 添加时间
  - add_time_text 添加时间文本
  - available_amount 可用充值卡余额变更值
  - freeze_amount 冻结充值卡余额变更值
  - description 描述

### 充值卡充值

#### 调用接口(post)

    index.php?app=member_fund&feiwa=rechargecard_add

#### 请求参数

- key 当前登录令牌
- rc_sn 平台充值卡号
- codekey 该接口需要验证码验证，该参数为验证码标识
- captcha 该接口需要验证码验证，该参数为验证码值

#### 操作成功

    //code返回code为200，datas返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回error，error内为错误信息
    {"code":200,"datas":{"error":"参数错误"}}

### 退款记录列表

#### 调用接口(get)

    index.php?app=member_refund&feiwa=get_refund_list

#### 请求参数

- key 当前登录令牌
- type 查询类型，可为空，order_sn：订单编号，refund_sn：退款编号，goods_name：商品名称
- k 查询内容，可为空
- add_time_from 退款提交的开始时间，可为空
- add_time_to 退款提交的结束时间，可为空

#### 返回数据

- refund_list 退款记录列表
  - refund_id 退款记录ID
  - order_id 订单ID
  - refund_amount 退款金额
  - refund_sn 退款编号
  - order_sn 订单编号
  - add_time 退款记录添加时间
  - seller_state_v 商家处理状态（数字:1为待审核,2为同意,3为不同意）
  - seller_state 商家处理状态（汉字）
  - admin_state_v 管理员处理状态（数字:1为处理中,2为待处理,3为已完成）
  - admin_state 管理员处理状态（汉字）
  - store_id 店铺编号
  - store_name 店铺名称
  - goods_list 商品列表
    - goods_id 商品编号
    - goods_name 商品名称
    - goods_spec 规格名称
    - goods_img_360 商品图，360px

### 查看退款信息

#### 调用接口(get)

    index.php?app=member_refund&feiwa=get_refund_info

#### 请求参数

- key 当前登录令牌
- refund_id 退款记录ID

#### 返回数据

- refund 退款记录
  - refund_id 退款记录ID
  - goods_id 商品编号
  - goods_name 商品名称
  - order_id 订单ID
  - refund_amount 退款金额
  - refund_sn 退款编号
  - order_sn 订单编号
  - add_time 退款记录添加时间
  - goods_img_360 商品图，360px
  - seller_state 商家处理状态
  - admin_state 管理员处理状态
  - store_id 商家编号
  - reason_info 退款原因内容
  - buyer_message 申请原因
  - seller_message 商家备注
  - admin_message 管理员备注
- pic_list 退款凭证数组，可为空
  - 序号 退款图片
- detail_array 退款详细，可为空
  - refund_code 退款支付方式
  - pay_amount 在线退款金额
  - pd_amount 预存款金额
  - rcb_amount 充值卡金额

### 全部退款信息

#### 调用接口(get)

    index.php?app=member_refund&feiwa=refund_all_form

#### 请求参数

- key 当前登录令牌
- order_id 订单ID

#### 返回数据

- order 订单记录
  - order_id 订单ID
  - order_type 订单类型1普通订单(默认),2预定订单,3门店自提订单
  - order_sn 订单编号
  - store_id 商家编号
  - store_name 商家名称
  - allow_refund_amount 可退款金额
  - book_amount 订金金额
- goods_list 商品列表
  - goods_id 商品编号
  - goods_name 商品名称
  - goods_type 促销类型
  - goods_img_360 商品图，360px
  - goods_price 商品价格
  - goods_spec 商品规格
  - goods_num 商品数量
- gift_list 赠品列表
  - 结构同goods_list

### 全部退款保存

#### 调用接口(post)

    index.php?app=member_refund&feiwa=refund_all_post

#### 请求参数

- key 当前登录令牌
- order_id 订单ID
- buyer_message 申请原因
- refund_pic 退款凭证数组（最多三个），可为空
  - 序号 退款图片

#### 返回数据

- 1

### 退款上传凭证保存

#### 调用接口(post)

    index.php?app=member_refund&feiwa=upload_pic

#### 请求参数

- key 当前登录令牌
- refund_pic 图片文件

#### 返回数据

- file_name 图片名称
- pic 带网址的图片路径

### 部分退款信息（退货信息）

#### 调用接口(get)

    index.php?app=member_refund&feiwa=refund_form

#### 请求参数

- key 当前登录令牌
- order_id 订单ID
- order_goods_id 订单商品ID

#### 返回数据

- order 订单记录
  - order_id 订单ID
  - order_type 订单类型1普通订单(默认),2预定订单,3门店自提订单
  - order_sn 订单编号
  - store_id 商家编号
  - store_name 商家名称
  - order_amount 订单金额
- goods 商品记录
  - store_id 商家编号
  - order_goods_id 订单商品表ID
  - goods_id 商品编号
  - goods_name 商品名称
  - goods_type 促销类型
  - goods_img_360 商品图，360px
  - goods_price 商品价格
  - goods_spec 商品规格
  - goods_num 商品数量
  - goods_pay_price 商品可退金额（根据商品实际成交价计算）
- reason_list 退款退货原因
  - reason_id 原因ID
  - reason_info 退款原因内容

### 部分退款信息（退货信息）保存

#### 调用接口(post)

    index.php?app=member_refund&feiwa=refund_post

#### 请求参数

- key 当前登录令牌
- order_id 订单ID
- order_goods_id 订单商品ID
- refund_amount 退款金额
- goods_num 退货数量
- reason_id 原因ID:0为其它
- buyer_message 申请原因
- refund_type 申请类型:1为退款,2为退货
- refund_pic 退款凭证数组（最多三个），可为空
  - 序号 退款图片

#### 返回数据

- 1

### 退货记录列表

#### 调用接口(get)

    index.php?app=member_return&feiwa=get_return_list

#### 请求参数

- key 当前登录令牌
- type 查询类型，可为空，order_sn：订单编号，refund_sn：退款编号，goods_name：商品名称
- k 查询内容，可为空
- add_time_from 退款提交的开始时间，可为空
- add_time_to 退款提交的结束时间，可为空

#### 返回数据

- return_list 退款记录列表
  - refund_id 退款记录ID
  - goods_id 商品编号
  - goods_name 商品名称
  - goods_spec 规格名称
  - goods_num 商品数量
  - goods_state_v 物流状态（数字:1为待发货,2为待收货,3为未收到,4为已收货）
  - ship_state 可退货
  - delay_state 可延时
  - goods_img_360 商品图，360px
  - order_id 订单ID
  - refund_amount 退款金额
  - refund_sn 退款编号
  - return_type 退货类型:1为不用退货,2为需要退货
  - order_sn 订单编号
  - add_time 退款记录添加时间
  - seller_state_v 商家处理状态（数字:1为待审核,2为同意,3为不同意）
  - seller_state 商家处理状态（汉字）
  - admin_state_v 管理员处理状态（数字:1为处理中,2为待处理,3为已完成）
  - admin_state 管理员处理状态（汉字）
  - store_id 店铺编号
  - store_name 店铺名称

### 查看退货信息

#### 调用接口(get)

    index.php?app=member_return&feiwa=get_return_info

#### 请求参数

- key 当前登录令牌
- return_id 退款退货记录ID

#### 返回数据

- refund 退款记录
  - refund_id 退款记录ID
  - goods_id 商品编号
  - goods_name 商品名称
  - goods_num 商品数量
  - goods_state_v 物流状态（数字:1为待发货,2为待收货,3为未收到,4为已收货）
  - ship_state 可退货
  - delay_state 可延时
  - order_id 订单ID
  - refund_amount 退款金额
  - refund_sn 退款编号
  - return_type 退货类型:1为不用退货,2为需要退货
  - order_sn 订单编号
  - add_time 退款记录添加时间
  - goods_img_360 商品图，360px
  - seller_state 商家处理状态
  - admin_state 管理员处理状态
  - store_id 商家编号
  - reason_info 退款原因内容
  - buyer_message 申请原因
  - seller_message 商家备注
  - admin_message 管理员备注
- pic_list 退款凭证数组，可为空
  - 序号 退款图片
- detail_array 退款详细，可为空
  - refund_code 退款支付方式
  - pay_amount 在线退款金额
  - pd_amount 预存款金额
  - rcb_amount 充值卡金额

### 退货发货信息

#### 调用接口(get)

    index.php?app=member_return&feiwa=ship_form

#### 请求参数

- key 当前登录令牌
- return_id 退货ID

#### 返回数据

- return_id 退货ID
- return_delay 数字（单位为天），发货默认n天后才能选择没收到
- return_confirm 数字（单位为天），商家不处理收货时按同意并弃货处理
- express_list 物流公司列表
  - express_id 物流公司编号
  - express_name 物流公司名称

### 退货发货保存

#### 调用接口(post)

    index.php?app=member_return&feiwa=ship_post

#### 请求参数

- key 当前登录令牌
- return_id 退货ID
- express_id 物流公司编号
- invoice_no 物流单号

#### 返回数据

- 1

### 退货延迟收货

#### 调用接口(get)

    index.php?app=member_return&feiwa=delay_form

#### 请求参数

- key 当前登录令牌
- return_id 退货ID

#### 返回数据

- return_id 退货ID
- return_delay 发货默认n天后才能选择没收到
- return_confirm 商家不处理收货时按同意并弃货处理

### 退货延迟收货保存

#### 调用接口(post)

    index.php?app=member_return&feiwa=delay_post

#### 请求参数

- key 当前登录令牌
- return_id 退货ID

#### 返回数据

- 1

### 初次绑定手机第一步-发送短信

#### 调用接口(post)

      index.php?app=member_account&feiwa=bind_mobile_step1

#### 请求参数

- key 当前登录令牌
- mobile 手机号码
- captcha 图形验证码
- codekey 图形验证码标识

#### 返回数据

- sms_time 下次发送时间间隔[秒]
- 验证失败: code为400，error内为错误信息

### 初次绑定手机第二步-验证短信码

#### 调用接口(post)

      index.php?app=member_account&feiwa=bind_mobile_step2

#### 请求参数

- key 当前登录令牌
- auth_code 短信验证码

#### 返回数据

- “1”

### 得到会员手机绑定状态及手机号

#### 调用接口

      index.php?app=member_account&feiwa=get_mobile_info

#### 请求参数

- key 登录令牌

#### 返回数据

- state true/false 是/否 绑定
- mobile 加*后的手机号码

### 更改绑定手机第二步-向已经绑定的手机发送验证码

#### 调用接口(post)

      index.php?app=member_account&feiwa=modify_mobile_step2

#### 请求参数

- key 当前登录令牌
- captcha 图形验证码
- codekey 图形验证码标识

#### 返回数据

- sms_time 下次发送时间间隔[秒]
- 验证失败: code为400，error内为错误信息

### 更改绑定手机 第三步-验证短信码

#### 调用接口(post)

      index.php?app=member_account&feiwa=modify_mobile_step3

#### 请求参数

- key 当前登录令牌
- auth_code 短信验证码

#### 返回数据

- “1”

### 通过支付密码修改绑定手机

#### 调用接口(post)

      index.php?app=member_account&feiwa=check_paypwd

#### 请求参数

- key 当前登录令牌
- codekey 图形验证码标识
- captcha 图形验证码
- password 支付密码

#### 返回数据

- “1”

### 更改密码第二步-向已经绑定的手机发送验证码

#### 调用接口(post)

      index.php?app=member_account&feiwa=modify_password_step2

#### 请求参数

- key 当前登录令牌
- captcha 图形验证码
- codekey 图形验证码标识

#### 返回数据

- sms_time 下次发送时间间隔[秒]
- 验证失败: code为400，error内为错误信息

### 更改密码第三步-验证短信码

#### 调用接口(post)

      index.php?app=member_account&feiwa=modify_password_step3

#### 请求参数

- key 当前登录令牌
- auth_code 短信验证码

#### 返回数据

- “1”

### 更改密码第四步-检查是否有权修改密码

#### 调用接口(post)

      index.php?app=member_account&feiwa=modify_password_step4

#### 请求参数

- key 当前登录令牌

#### 返回数据

- “1”

### 更改密码第五步-保存新密码到数据库

#### 调用接口(post)

      index.php?app=member_account&feiwa=modify_password_step5

#### 请求参数

- key 当前登录令牌
- password 密码
- password1 确认密码

#### 返回数据

- “1”

### 检测是否设置了支付密码

#### 调用接口

      index.php?app=member_account&feiwa=get_paypwd_info

#### 请求参数

- key 登录令牌

#### 返回数据

- state true/false 是/否

### 更改支付密码第二步-向已经绑定的手机发送验证码

#### 调用接口(post)

      index.php?app=member_account&feiwa=modify_paypwd_step2

#### 请求参数

- key 当前登录令牌
- captcha 图形验证码
- codekey 图形验证码标识

#### 返回数据

- sms_time 下次发送时间间隔[秒]
- 验证失败: code为400，error内为错误信息

### 更改支付密码第三步-验证短信码

#### 调用接口(post)

      index.php?app=member_account&feiwa=modify_paypwd_step3

#### 请求参数

- key 当前登录令牌
- auth_code 短信验证码

#### 返回数据

- “1”

### 更改支付密码第四步-检查是否有权修改密码

#### 调用接口(post)

      index.php?app=member_account&feiwa=modify_paypwd_step4

#### 请求参数

- key 当前登录令牌

#### 返回数据

- “1”

### 更改支付密码第五步-保存新密码到数据库

#### 调用接口(post)

      index.php?app=member_account&feiwa=modify_paypwd_step5

#### 请求参数

- key 当前登录令牌
- password 密码
- password1 确认密码

#### 返回数据

- “1”

### 签到

#### 调用接口

      index.php?app=member_signin&feiwa=signin_add

#### 请求参数

- key 当前登录令牌

#### 操作成功

    //code返回code为200
    * point     会员积分

#### 错误

    //出现错误返回code为400，error内为错误信息
    {"code":400,"datas":{"error":"参数错误"}}

### 检验是否已签到

#### 调用接口

      index.php?app=member_signin&feiwa=checksignin

#### 请求参数

- key 当前登录令牌

#### 操作成功

    //code返回code为200
    * points_signin    签到可获得积分数

#### 错误

    //出现错误返回code为400，error内为错误信息

### 签到日志

#### 调用接口

      index.php?app=member_signin&feiwa=signin_list

#### 请求参数

- key 当前登录令牌

#### 返回数据

- signin_list
  - sl_id 日志序号
  - sl_memberid 会员ID
  - sl_membername 会员名称
  - sl_addtime 添加时间
  - sl_points 获得积分数
  - sl_addtime_text 添加时间文本

## 店铺

### 店铺详情接口

#### 请求接口(get)

    index.php?app=store&feiwa=store_info

#### 请求参数

- store_id 店铺ID
- key 登录令牌（可选），登陆后提交令牌返回是否已经收藏该店铺

#### 返回数据

- store_info
  - store_id 店铺ID
  - store_name 店铺名称
  - store_avatar 店铺头像
  - goods_count 商品数
  - store_collect 收藏数
  - is_favorate 如果传递登录令牌，则返回该店铺是否已被收藏
  - is_own_mall 是否自营店
  - store_credit_text 店铺动态评分
  - mb_title_img 页头背景图
  - mb_sliders[] 轮播多图
    - img: 图片名称
    - imgUrl: 图片地址
    - type: 链接类型 （1: URL地址 2: 商品ID）
    - link: 链接内容 URL地址或商品ID
  - rec_goods_list_count 推荐商品数
  - rec_goods_list[] 推荐商品

### 店铺排行榜

#### 请求接口(post)

    index.php?app=store&feiwa=store_goods_rank

#### 请求参数

- store_id 店铺编号
- ordertype 类型：collectdesc-收藏排行 salenumdesc-销量排行
- num 数量

#### 返回数据

- goods_list
  - goods_id 商品编号
  - goods_name 商品名称
  - goods_price 商品价格
  - goods_salenum 商品销量
  - goods_image_url 商品图片地址

### 店铺评分

#### 请求接口(get)

    index.php?app=store&feiwa=store_credit

#### 请求参数

- store_id 店铺ID

#### 返回数据

- store_credit 店铺评分
  - store_desccredit 描述
    - text 文字描述
    - credit 评分
    - percent 百分比
    - percent_class 百分比class low-低 equal-平 high-高
    - percent_text 百分比文字
  - store_servicecredit 服务
    - text 文字描述
    - credit 评分
    - percent 百分比
    - percent_class 百分比class low-低 equal-平 high-高
    - percent_text 百分比文字
  - store_deliverycredit 物流
    - text 文字描述
    - credit 评分
    - percent 百分比
    - percent_class 百分比class low-低 equal-平 high-高
    - percent_text 百分比文字

### 店铺商品分类

#### 请求接口（get/post）

    index.php?app=store&feiwa=store_goods_class

#### 请求参数

- store_id 店铺ID

#### 返回数据

- store_info
  - store_id 店铺ID
  - store_name 店铺名称
- store_goods_class[] 店铺商品分类
  - id 分类ID
  - name 分类名称
  - level 分类层级，只有1和2级
  - pid 上级分类ID（若为1级则为0）

### 店铺商品列表

#### 请求接口(get)

    index.php?app=store&feiwa=store_goods

#### 请求参数

- store_id 店铺ID
- stc_id 店铺商品分类ID
- keyword 关键词
- page 每页显示数量
- key 排序字段 1发布时间 2价格 3销量 4收藏数
- order 排序顺序 1正序 2倒叙
- curpage 当前页
- price_from 价格区间起始值
- price_to 价格区间终止值
- prom_type 促销类型 例如xianshi或者groupbuy

#### 返回数据

- goods_id 商品编号
- goods_commonid 商品公共表id
- store_id 店铺ID
- store_name 店铺名称
- goods_name 商品名称
- goods_price 商品价格
- goods_promotion_type 促销类型
- goods_promotion_price 促销价格
- goods_marketprice 商品市场价
- goods_salenum 销量
- evaluation_good_star 评价星级
- evaluation_count 评价数
- sole_flag 是否手机专享
- group_flag 是否团购
- xianshi_flag 是否限时折扣
- goods_image 图片名称
- goods_image_url 图片地址
- is_fcode 是否为F码商品 1-是 0-否
- is_appoint 是否是预约商品 1-是 0-否
- is_presell 是否是预售商品 1-是 0-否
- have_gift 是否拥有赠品 1-是 0-否

### 店铺商品上新

#### 请求接口

    index.php?app=store&feiwa=store_new_goods

#### 请求参数

- store_id 店铺ID
- show_day 上新天数，非必填，默认30天

#### 返回数据

- goods_id 商品编号
- goods_commonid 商品公共表id
- store_id 店铺ID
- store_name 店铺名称
- goods_name 商品名称
- goods_price 商品价格
- goods_promotion_type 促销类型
- goods_promotion_price 促销价格
- goods_marketprice 商品市场价
- goods_salenum 销量
- evaluation_good_star 评价星级
- evaluation_count 评价数
- sole_flag 是否手机专享
- group_flag 是否团购
- xianshi_flag 是否限时折扣
- goods_image 图片名称
- goods_image_url 图片地址
- is_fcode 是否为F码商品 1-是 0-否
- is_appoint 是否是预约商品 1-是 0-否
- is_presell 是否是预售商品 1-是 0-否
- have_gift 是否拥有赠品 1-是 0-否
- goods_addtime 添加时间

### 店铺简介

#### 请求接口

    index.php?app=store&feiwa=store_intro

#### 请求参数

- store_id 店铺ID

#### 返回数据

- store_id 店铺编号
- store_name 店铺名称
- grade_id 等级
- member_id 会员ID
- member_name 会员名称
- seller_name 店主名
- sc_id 店铺分类ID
- sc_name 店铺分类名称
- store_company_name 公司名称
- province_id 省份ID
- area_info 地区详情
- store_address 店铺地址
- store_zip 店铺邮编
- store_state 店铺状态
- store_time 开店时间
- store_time_text 开店时间文字
- store_end_time 结束时间
- store_label 店铺logo
- store_banner 店铺横幅
- store_avatar 店铺头像
- store_keywords 店铺seo关键字
- store_description 店铺seo描述
- store_qq 店铺QQ
- store_ww 阿里旺旺
- store_phone 商家电话
- store_zy 主营商品
- store_domain 店铺二级域名
- store_recommend 推荐
- store_theme 店铺当前主题
- store_credit 店铺信用
  - text 信用类型文字
  - credit 信用值
  - percent 同行水平百分比
  - percent_class 同行水平返回值有high、equal、low
  - percent_text 同行水平文字
- store_collect 店铺收藏数
- store_slide 幻灯片
- store_slide_url 店铺幻灯片链接
- store_sales 店铺销量
- store_presales 售前客服
- store_aftersales 售后客服
- store_workingtime 工作时间
- store_free_price 超出该金额免运费
- is_own_mall 是否自营店铺
- mb_title_img 手机店铺 页头背景图
- mb_sliders 手机店铺 轮播图链接地址

### 店铺促销活动

#### 请求接口

    index.php?app=store&feiwa=store_promotion

#### 请求参数

- store_id 店铺ID
- fields 需要返回的数据，例如'mansong','xianshi'

#### 返回数据

- promotion 促销数组
  - mansong 满就送促销信息
    - mansong_id 促销ID
    - mansong_name 促销名称
    - quota_id 促销名称
    - start_time 开始时间
    - end_time 结束时间
    - start_time_text 开始时间文字
    - end_time_text 结束时间文字
    - member_id 会员ID
    - store_id 店铺ID
    - member_name 会员名称
    - store_name 店铺名称
    - state 活动状态
    - mansong_state_text 状态文字
    - remark 活动说明
      - rules 活动规则数组
        - rule_id 规则ID
        - mansong_id 满就送活动ID
        - price 满额值
        - discount 减少金额
        - mansong_goods_name 赠品名称
        - goods_id 赠品ID
        - goods_image 赠品图片
        - goods_image_url 赠品图片地址
        - goods_storage 商品库存
        - goods_url 商品地址
  - xianshi 限时折扣详情
    - xianshi_id 活动ID
    - xianshi_name 活动名称
    - xianshi_title 活动标题
    - xianshi_explain 活动说明
    - quota_id 套餐ID
    - start_time 开始时间
    - end_time 结束时间
    - start_time_text 开始时间文字
    - end_time_text 结束时间文字
    - member_id 会员ID
    - store_id 店铺ID
    - member_name 会员名称
    - store_name 店铺名称
    - lower_limit 最低购买件数限制
    - state 活动状态
    - xianshi_state_text 活动状态文字

### 店铺代金券模板

#### 请求接口

    index.php?app=voucher&feiwa=voucher_tpl_list

#### 请求参数

- store_id 店铺ID（可选）
- gettype 代金券类型 参考值points或者free默认为两者全显示（可选）

#### 返回数据

- voucher_list
  - voucher_t_id 代金券模板ID
  - voucher_t_title 代金券模板标题
  - voucher_t_desc 代金券模板描述
  - voucher_t_start_date 代金券模板开始时间
  - voucher_t_end_date 代金券模板结束时间
  - voucher_t_end_date_text 代金券模板结束时间文字
  - voucher_t_price 代金券模板金额
  - voucher_t_limit 代金券使用时的订单限额
  - voucher_t_store_id 店铺ID
  - voucher_t_storename 店铺名称
  - voucher_t_sc_id 所属店铺分类ID
  - voucher_t_state 代金券模版状态(1-有效,2-失效)
  - voucher_t_state_text 代金券模版状态文字
  - voucher_t_total 模版可发放的代金券总数
  - voucher_t_giveout 模版已发放的代金券数量
  - voucher_t_used 模版已经使用过的代金券
  - voucher_t_add_date 模版的创建时间
  - voucher_t_quotaid 套餐ID
  - voucher_t_points 兑换所需积分
  - voucher_t_eachlimit 每人限领张数
  - voucher_t_customimg 自定义代金券模板图片
  - voucher_t_recommend 是否推荐 0不推荐 1推荐
  - voucher_t_gettype 领取方式 1积分兑换 2卡密兑换 3免费领取
  - voucher_t_gettype_key 领取方式标识
  - voucher_t_gettype_text 领取方式文字
  - voucher_t_mgradelimit 领取代金券限制的会员等级
  - voucher_t_mgradelimittext 限制的会员等级名称
  - voucher_t_sc_name 店铺分类

### 我的收藏店铺列表

#### 请求接口(get)

    index.php?app=member_favorites_store&feiwa=favorites_list

#### 请求参数

- key 登录令牌

#### 返回数据

- favorites_list[]
  - store_id 店铺ID
  - store_name 店铺名称
  - fav_time 收藏时间戳
  - fav_time_text 收藏时间
  - goods_count 商品数
  - store_collect 收藏数
  - store_avatar 店铺头像文件名
  - store_avatar_url 店铺头像文件URL

### 我的收藏店铺新增

#### 请求接口(post)

    index.php?app=member_favorites_store&feiwa=favorites_add

#### 请求参数

- store_id 店铺ID
- key 登录令牌

#### 返回数据

    '1'

### 我的收藏店铺删除

#### 请求接口(post)

    index.php?app=member_favorites_store&feiwa=favorites_del

#### 请求参数

- store_id 店铺ID
- key 登录令牌

#### 返回数据

    '1'

## 商家

### 商家登录

#### 调用接口(post)

      index.php?app=seller_login

#### 请求参数

- seller_name 用户名
- password md5加密后的密码(MD5在客户端进行)
- client 客户端类型(windows)

#### 返回数据

- seller_name 用户名
- store_name 店铺名称
- key 登录令牌

### 商家注销

#### 调用接口(post)

      index.php?app=seller_logout

#### 请求参数

- seller_name 用户名
- key 当前登录令牌
- client 客户端类型(windows)

#### 返回数据

- '1'

### 商家商品列表

#### 调用接口(POST)

    本接口支持分页

    index.php?app=seller_goods&feiwa=goods_list

#### 请求参数(POST)

- *key 当前登录令牌
- keyword 商品搜索关键字
- search_type 搜索类型，默认0 0-商品名称 1-商家货号 2-商品CommonID
- goods_type 商品类型，默认online online-在售商品 offline-仓库商品 lockup-禁售商品

#### 返回参数

- goods_list
  - goods_commonid 商品CommonID
  - goods_name 商品名称
  - goods_price 商品价格
  - goods_storage_sum 商品库存
  - goods_addtime 商品发布时间(2015-1-1)
  - goods_image 商品图片URL
  - goods_state 商品状态 0-仓库 1-在售 10-禁售
  - goods_lock 商品锁定 0-未锁 1-已锁

### 商家订单列表

#### 调用接口(POST)

    本接口支持分页

    index.php?app=seller_order&feiwa=order_list

#### 请求参数(POST)

- *key 当前登录令牌
- order_sn 订单sn
- buyer_name 买家名称
- state_type 订单类型 0-已取消 10-未支付 20-已付款 30-已发货 40-已完成
- query_start_date 下单时间开始(2015-1-1)
- query_end_date 下单时间结束(2015-2-1)
- skip_off 是否跳过已取消订单，默认0 0-不跳过 1-跳过

#### 返回参数

- order_list[]
  - order_id 订单编号
  - order_sn 订单sn
  - store_name 店铺名称
  - buyer_id 买家名称
  - buyer_name 买家名称
  - add_time 订单生成时间(timestamp)
  - goods_amount 商品总额
  - order_amount 订单总额
  - shipping_fee 运费
  - state_desc 状态描述文字
  - if_store_cancel 店铺是否可以取消 true/false
  - if_modify_price 店铺是否可以修改价格 true/false
  - if_store_send 店铺是否可以发货 true/false
  - if_lock 是否锁定中 true/false
  - if_deliver 是否可以查看物流 true/false

### 商家可用商品分类

#### 调用接口(post)

      index.php?app=seller_goods_class&feiwa=class_list

#### 请求参数

- key 当前登录令牌
- gc_id 父级分类编号，顶级分类为0
- deep 请求分类深度，一级-1、二级-2、三级-3

#### 返回数据

- class_list 格式为数组
  - gc_id 分类编号
  - gc_name 分类名称

### 商家规格属性

#### 调用接口(post)

      index.php?app=seller_goods_class&feiwa=type_info

#### 请求参数

- key 当前登录令牌
- gc_id 商品所选分类编号

#### 返回数据

- type_id 类型编号
- spec_list 规格列表，数组
  - sp_id 规格编号
  - sp_name 规格名称
  - sp_format 规格格式
  - value 规格值，数组
    - sp_value_id 规格值编号
    - sp_value_name 规格值名称
    - sp_value_color 规格值颜色
- attr_list 属性，数组
  - attr_id 属性编号
  - attr_name 属性名称
  - value 属性值，数组
    - attr_value_id 属性值编号
    - attr_name_name 属性值名称

### 商家店铺商品分类

#### 调用接口(post)

      index.php?app=seller_store_goods_class&feiwa=class_list

#### 请求参数

- key 当前登录令牌

#### 返回数据

- class_list 格式为数组
  - id 分类编号
  - name 分类名称
  - level 分类级别 1-一级分类 2-二级分类

### 商家运费模板

#### 调用接口(post)

      index.php?app=seller_transport&feiwa=transport_list

#### 请求参数

- key 当前登录令牌

#### 返回数据

- transport_list 格式为数组
  - id 模板编号
  - title 模板标题

### 商品发布

#### 请求接口(post)

      index.php?app=seller_goods&feiwa=goods_add

#### 请求参数

- key 商家登录令牌
- cate_id 商品分类编号
- cate_name 商品分类名称 例：服饰鞋帽&gt;女装&gt;针织衫
- g_name 商品名称
- g_jingle 商品卖点
- spec 提交的规格，参见下方范例
- sp_name 规格名称，参见下方范例
- sp_value 规格值，参见下方范例
- type_id 类型编号
- attr 商品属性，参见下方范例
- g_price 商品价格
- g_marketprice 市场价
- g_costprice 成本价
- g_discount 折扣
- g_storage 商品库存
- g_alarm 库存预警值
- g_serial 商家货号
- g_body 商品描述
- m_body 手机描述
- province_id 所在地一级
- city_id 所在地二级
- g_freight 运费
- freight 使用运费模板 0-不使用 1-使用
- transport_id 运费模板编号
- transport_title 运费模板标题
- g_vat 是否增值税发票 0-否 1-是
- sgcate_id 本店分类编号
- g_commend 商品推荐 0-不推荐 1-推荐
- image_path 商品主图文件名称
- image_all 其它商品图文件名，用逗号分隔
- g_state 商品状态 0-下架 1-正常

#### sp_name范例

    所有规格，下标为规格编号，值为规格名称

- sp_name[1]=颜色
- sp_name[15]=尺寸

#### sp_value范例

    所有规格值，一级下标为规格编号，二级下标为规格值编号，值为规格值名称

- sp_value[1][247]=黑色
- sp_value[15][434]=XL

#### spec范例

    所有规格值组合，数组一级下标为"i_"加上规格组合编号

- spec[i_247434][alarm] 预警值
- spec[i_247434][barcode] 条码
- spec[i_247434][marketprice] 市场价
- spec[i_247434][price] 商品价格
- spec[i_247434][sku] 商家货号
- spec[i_247434][stock] 库存
- spec[i_247434][color_id] 颜色编号，如果规格中有颜色
- spec[i_247434][sp_value][247]=黑色 具体规格
- spec[i_247434][sp_value][434]=XL 具体规格

#### attr范例

- attr[206][name]=材质 206为属性编号，“材质”为属性名称
- attr[206][2050]=棉 206为属性编号，2050为属性所选值得编号，“棉”为属性所选值的文字

#### 返回数据

- common_id 商品公共编号

### 商品图片上传

#### 请求接口(post)

      index.php?app=seller_album&feiwa=image_upload

#### 请求参数

- key 商家登录令牌
- name FILES字段名
- FILES 图片

#### 返回数据

- image_name 商城图片名称

### 获取淘宝appkey

#### 请求接口(post)

      index.php?app=seller_taobao_api&feiwa=get_taobao_app_key

#### 请求参数

- key 商家登录令牌

#### 返回数据

- taobao_app_key 淘宝appkey

### 获取淘宝签名(sign)

#### 请求接口(post)

      index.php?app=seller_taobao_api&feiwa=get_taobao_sign

#### 请求参数

- key 商家登录令牌
- sign_string 签名字符串

#### 返回数据

- taobao_sign 淘宝签名(sign)

### 获取淘宝SessionKey

#### 请求接口(post)

      index.php?app=seller_taobao_api&feiwa=get_taobao_session_key

#### 请求参数

- key 商家登录令牌
- auth_code 授权号

#### 返回数据

- taobao_session_key 淘宝SessionKey

### 商品详细信息

#### 请求接口(post)

      index.php?app=seller_goods&feiwa=goods_info

#### 请求参数

- key 商家登录令牌
- goods_commonid 商品CommonID（SPU）

#### 返回数据

- goodscommon_info
  - goods_commonid 商品SPU
  - goods_name 商品名称
  - goods_jingle 广告语
  - gc_id 分类id
  - gc_id_1 一级分类id
  - gc_id_2 二级分类id
  - gc_id_3 三级分类id
  - gc_name 分类名称
  - store_id 店铺id
  - store_name 店铺名称
  - g_storage 商品总库存
  - spec_name 规格
    - 规格id 规格名称
  - spec_value 规格值（序列化）
  - brand_id 品牌id
  - brand_name 品牌名称
  - type_id 类型id
  - goods_image 商品图
  - goods_image_url 商品图链接
  - goods_attr 商品属性（序列化）
  - goods_custom 自定义属性（序列化）
  - goods_body 商品描述
  - mobile_body 手机端描述
  - goods_state 商品状态
  - goods_stateremark 下架原因
  - goods_verify 商品审核状态
  - goods_verifyremark 审核失败原因
  - goods_lock 商品锁定状态
  - goods_addtime 添加时间
  - goods_selltime 自动上架时间
  - goods_price 商品价格
  - goods_marketprice 市场价
  - goods_costprice 成本价
  - goods_discount 折扣
  - goods_serial 商家编号
  - goods_storage_alarm 库存预警
  - goods_barcode 商品条码
  - transport_id 运费模板id
  - transport_title 运费模板标题
  - goods_commend 商品推荐
  - goods_freight 运费
  - goods_vat 是否开具增值税发票
  - areaid_1 一级地区id
  - areaid_2 二级地区id
  - goods_stcids 店铺分类id串
  - plateid_top 顶部关联板式
  - plateid_bottom 底部关联板式
  - is_virtual 虚拟商品标示
  - virtual_indate 有效期
  - virtual_limit 购买上限
  - virtual_invalid_refund 是否允许过去退款
  - is_appoit 预约标示
  - appoint_satedate 预约商品出售时间
  - sup_id 供应商id
  - is_own_mall 自营商品标示
- sp_value 商品规格数据
  - spec_ids 规格值id数组（从小到大排列）
  - marketprice 市场价
  - price 价格
  - id 商品id（SKU）
  - stock 库存
  - alarm 库存预警
  - sku 商家编号
  - barcode 商品条码
  - marketprice 市场价
- attr_checked 选中的属性id和属性值id数组
  - attr_id 属性id
  - attr_value_id 属性值id
- spec_checked 选中的规格id和名称数组
  - id 规格id
  - name 规格名称
- spec_json
  - sp_id 规格id
    - sp_value_id 规格值id
      - sp_value_name 规格值名称
      - sp_value_color 规格值颜色
- spec_list
  - sp_id 规格id
    - sp_name 规格名称
    - value 规格值数组
      - sp_value_id 规格值id
      - sp_value_name 规格值名称
      - sp_value_color 规格值颜色
- attr_list
  - attr_id 属性id
    - attr_name 属性名称
    - value 属性值数组
      - attr_value_id 属性值id
      - attr_value_name 属性值名称
- image_list 商品图片列表
  - color_id 颜色id
    - goods_image_id
    - goods_commonid
    - store_id
    - color_id
    - goods_image
    - goods_image_sort
    - is_default

### 商品图片详细信息

#### 请求接口(post)

      index.php?app=seller_goods&feiwa=goods_image_info

#### 请求参数

- key 商家登录令牌
- goods_commonid 商品CommonID（SPU）

#### 返回数据

- image_list 商品图片列表
  - color_id 颜色id
  - spec_name 规格值名称
  - images
    - goods_image_id
    - goods_commonid
    - store_id
    - color_id 颜色规格的规格值id
    - goods_image 商品图
    - goods_image_url 商品图链接
    - goods_image_sort 排序
    - is_default 1为默认主题，每组color_id只有一个

### 商品编辑

#### 请求接口(post)

      index.php?app=seller_goods&feiwa=goods_edit

#### 请求参数

- key 商家登录令牌
- commonid 商品commonid（SPU）
- cate_id 商品分类编号
- cate_name 商品分类名称 例：服饰鞋帽&gt;女装&gt;针织衫
- g_name 商品名称
- g_jingle 商品卖点
- spec 提交的规格，参见下方范例
- sp_name 规格名称，参见下方范例
- sp_value 规格值，参见下方范例
- type_id 类型编号
- attr 商品属性，参见下方范例
- g_price 商品价格
- g_marketprice 市场价
- g_costprice 成本价
- g_discount 折扣
- g_storage 商品库存
- g_alarm 库存预警值
- g_serial 商家货号
- g_barcode 商品条形码
- g_body 商品描述
- m_body 手机描述
- province_id 所在地一级
- city_id 所在地二级
- g_freight 运费
- freight 使用运费模板 0-不使用 1-使用
- transport_id 运费模板编号
- transport_title 运费模板标题
- g_vat 是否增值税发票 0-否 1-是
- sgcate_id 本店分类编号
- g_commend 商品推荐 0-不推荐 1-推荐
- image_path 商品主图文件名称
- g_state 商品状态 0-下架 1-正常

#### sp_name范例

    所有规格，下标为规格编号，值为规格名称

- sp_name[1]=颜色
- sp_name[15]=尺寸

#### sp_value范例

    所有规格值，一级下标为规格编号，二级下标为规格值编号，值为规格值名称

- sp_value[1][247]=黑色
- sp_value[15][434]=XL

#### spec范例

    所有规格值组合，数组一级下标为"i_"加上规格组合编号

- spec[i_1][alarm] 预警值
- spec[i_1][barcode] 条码
- spec[i_1][marketprice] 市场价
- spec[i_1][price] 商品价格
- spec[i_1][sku] 商家货号
- spec[i_1][stock] 库存
- spec[i_1][color_id] 颜色编号，如果规格中有颜
- spec[i_1][goods_id] 商品id（SKU）
- spec[i_1][sp_value][247]=黑色 具体规格
- spec[i_1][sp_value][434]=XL 具体规格

#### attr范例

- attr[206][name]=材质 206为属性编号，“材质”为属性名称
- attr[206][2050]=棉 206为属性编号，2050为属性所选值得编号，“棉”为属性所选值的文字

#### 返回数据

- common_id 商品公共编号

### 商品图片编辑

#### 请求接口(post)

      index.php?app=seller_goods&feiwa=goods_edit_image

#### 请求参数

- key 商家登录令牌
- commonid 商品commonid（SPU）
- img 商品图数组，规则请看img范例

#### img范例

      img[206][1][name]=1_04752627678636481.jpg  // 图片名称
      img[206][1][sort]=0 // 排序
      img[206][1][default]=1 // 默认主题
      img[206][2][name]=1_04752627678636482.jpg
      img[206][2][sort]=0
      img[206][2][default]=0
      // 206 为颜色规格的规格值id

#### 操作成功

    //操作成返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回error，error内为错误信息
    {"code":200,"datas":{"error":"参数错误"}}

### 商品上架

#### 调用接口(post)

      index.php?app=seller_goods&feiwa=goods_show

#### 请求参数

- key 当前登录令牌
- commonids[] 商品公共编号(SPU)

#### 操作成功

    //操作成返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回error，error内为错误信息
    {"code":200,"datas":{"error":"参数错误"}}

### 商品下架

#### 调用接口(post)

      index.php?app=seller_goods&feiwa=goods_unshow

#### 请求参数

- key 当前登录令牌
- commonids[] 商品公共编号(SPU)

#### 操作成功

    //操作成返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回error，error内为错误信息
    {"code":200,"datas":{"error":"参数错误"}}

### 商品删除

#### 调用接口(post)

      index.php?app=seller_goods&feiwa=goods_drop

#### 请求参数

- key 当前登录令牌
- commonids[] 商品公共编号(SPU)

#### 操作成功

    //操作成返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回error，error内为错误信息
    {"code":200,"datas":{"error":"参数错误"}}

### 取消订单

#### 调用接口(post)

      index.php?app=seller_order&feiwa=order_cancel

#### 请求参数

- key 当前登录令牌
- order_id 订单ID
- reason 关闭原因

#### 操作成功

    //操作成返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回error，error内为错误信息
    {"code":200,"datas":{"error":"参数错误"}}

### 修改运费

#### 调用接口(post)

      index.php?app=seller_order&feiwa=order_ship_price

#### 请求参数

- key 当前登录令牌
- order_id 订单ID
- shipping_fee 修改后的运费金额

#### 操作成功

    //操作成返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回error，error内为错误信息
    {"code":200,"datas":{"error":"参数错误"}}

### 店铺默认物流公司

#### 调用接口(post)

      index.php?app=seller_express&feiwa=get_list

#### 请求参数

- key 当前登录令牌

#### 返回数据

- express_array[]
  - id 索引ID
  - e_name 公司名称
  - e_state 状态
  - e_code 编号
  - e_letter 首字母
  - e_order 1常用2不常用
  - e_url 公司网址
  - e_zt_state 是否支持服务站配送0否1是

### 自提服务站使用物流公司

#### 调用接口(post)

      index.php?app=seller_express&feiwa=get_zt_list

#### 请求参数

- key 当前登录令牌

#### 返回数据

- express_array[]
  - id 索引ID
  - e_name 公司名称
  - e_state 状态
  - e_code 编号
  - e_letter 首字母
  - e_order 1常用2不常用
  - e_url 公司网址
  - e_zt_state 是否支持服务站配送0否1是

### 商家发货

#### 调用接口(post)

      index.php?app=seller_order&feiwa=order_deliver_send

#### 请求参数

- key 当前登录令牌
- order_id 订单ID
- deliver_explain 发货备注
- shipping_express_id 配送公司ID
- shipping_code 物流单号

#### 操作成功

    //操作成返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回error，error内为错误信息
    {"code":200,"datas":{"error":"参数错误"}}

## 虚拟购买

### 虚拟购买第一步

#### 调用接口(post)

    index.php?app=member_vr_buy&feiwa=buy_step1

#### 请求参数

- key当前登录令牌
- cart_id 商品编号
- quantity 购买数量

#### 返回数据

- goods_info 商品信息
- store_info 店铺信息

### 虚拟购买第二步

    设置接收手机号

#### 调用接口(post)

    index.php?app=member_vr_buy&feiwa=buy_step2

#### 请求参数

- key当前登录令牌
- goods_id 商品编号
- quantity 购买数量

#### 返回数据

- goods_info 商品信息
- store_info 店铺信息
- $member_info 会员信息

### 虚拟购买第三步

    生成订单

#### 调用接口(post)

    index.php?app=member_vr_buy&feiwa=buy_step3

#### 请求参数

- key当前登录令牌
- goods_id 商品编号
- quantity 购买数量
- buyer_phone 接收手机
- pd_pay 是否使用预存款 1-是 0-否
- password 支付密码(可以提前使用“验证支付密码”接口进行验证)

#### 返回数据

- order_id 订单编号

### 虚拟购买第四步-选择支付方式

#### 调用接口(post)

      index.php?app=member_vr_buy&feiwa=pay

#### 请求参数

- key 当前登录令牌
- pay_sn 订单号

#### 返回数据

- pay_info
  - pay_amount 未支付金额
  - member_available_pd 可用预存款
  - member_available_rcb 可用充值卡
  - member_paypwd 是否设置了支付密码 true/false
  - payed_amount 已经支付(预存款+充值卡)的金额，如果该值大于0，则不再需要选择使用预存款或充值卡。
  - payment_list
    - payment_name 支付方式名称
    - payment_code 支付方式代码

### 虚拟购买第五步-选择完支付方式跳往第三方支付平台

#### 调用接口(get)

      index.php?app=member_payment&feiwa=vr_pay_new

#### 请求参数

- key 当前登录令牌
- pay_sn 支付单号
- password 支付密码
- rcb_pay 是否使用充值卡 1/0
- pd_pay 是否使用预存款 1/0
- payment_code 支付方式代码

#### 返回数据

### 虚拟订单列表

#### 调用接口(post)

    index.php?app=member_vr_order&feiwa=order_list

#### 请求参数

- key当前登录令牌
- state_type 订单状态（可不填） state_new待支付，state_pay待使用

#### 返回数据

- order_list 订单列表
  - if_evaluation 是否可评价

### 虚拟订单详情

#### 调用接口(get)

      index.php?app=member_vr_order&feiwa=order_info

#### 请求参数

- key 当前登录令牌
- order_id 订单ID

#### 返回数据

- order_info
  - order_id 订单ID
  - order_sn 订单编号
  - store_id 店铺ID
  - store_name 店铺名
  - add_time 下单时间
  - buyer_phone 电话
  - payment_time 支付时间
  - finnshed_time 完成时间
  - order_amount 订单金额
  - refund_amount 退款金额
  - state_desc 订单状态
  - goods_id 商品ID
  - goods_name 商品名字
  - goods_price 单价
  - goods_num 购买数量
  - goods_image_url 商品图
  - vr_indate 有效期
  - if_cancel 是否可以取消订单 true/false
  - if_refund 是否允许订单退款 true/false
  - if_evaluation 是否允许评价 true/false
  - ownmall 是否自营店 true/false
  - if_resend 是否重新发送短信 true/false
  - code_list 兑换码列表
    - vr_code 兑换码
    - vr_state 状态0:(默认)未使用1:已使用2:已过期

### 虚拟订单可用码列表

#### 调用接口(post)

    index.php?app=member_vr_order&feiwa=indate_code_list

#### 请求参数

- key当前登录令牌
- order_id 订单编号

#### 返回数据

- code_list 支付码列表
  - vr_code 支付码
  - vr_indate 使用期限

### 虚拟订单取消

#### 调用接口(post)

    index.php?app=member_vr_order&feiwa=order_cancel

#### 请求参数

- key当前登录令牌
- order_id 订单编号

#### 返回数据

- '1'

### 虚拟订单重发验证码

#### 调用接口(post)

    index.php?app=member_vr_order&feiwa=resend

#### 请求参数

- key当前登录令牌
- order_id 订单编号
- buyer_phone 手机号

#### 返回数据

- '1'

### 虚拟订单支付

#### 调用接口(get)

      index.php?app=member_payment&feiwa=vr_pay

#### 请求参数

- key 当前登录令牌
- pay_sn 支付编号(虚拟订单order_sn)

### 获取虚拟订单微信APP支付信息

#### 调用接口(post)

      index.php?app=member_payment&feiwa=wx_app_vr_pay

#### 请求参数

- key 当前登录令牌
- pay_sn 支付单编号(虚拟订单order_sn)

#### 返回数据

- appid 微信开放平台appid
- noncestr 随机字符串
- package 支付内容
- partnerid 财付通id
- prepayid 微信预支付编号
- sign 签名
- timestamp 时间戳

### 获取虚拟订单微信APP支付信息(v3)

#### 调用接口(post)

      index.php?app=member_payment&feiwa=wx_app_vr_pay3

#### 请求参数

- key 当前登录令牌
- pay_sn 支付单编号(虚拟订单order_sn)

#### 返回数据

- appid 微信开放平台appid
- noncestr 随机字符串
- package 支付内容
- partnerid 财付通id
- prepayid 微信预支付编号
- sign 签名
- timestamp 时间戳

### 评价（虚拟）

#### 调用接口

      index.php?app=member_evaluate&feiwa=vr

#### 请求参数

- key 当前登录令牌
- order_id 订单id

#### 返回数据

- store_info 店铺信息
  - store_id 店铺id
  - store_name 店铺名称
- order_goods 订单商品信息
  - order_id 订单id
  - goods_id 商品id
  - goods_name 商品名称
  - goods_price 商品价格
  - goods_num 购买数量
  - goods_image 商品图片
  - goods_image_url 商品图片路径

### 评价商品（虚拟）

#### 调用接口(post)

    index.php?app=member_evaluate&feiwa=save_vr

#### 请求参数

- key 当前登录令牌
- order_id 订单id
- goods 评价商品
  - 0 评价商品/店铺接口的order_info的goods_id
    - score 商品评分1~5
    - comment 评论内容，不超过150个字符
    - anony 是否匿名评价，1为匿名/0为不匿名

#### 返回数据

- '1'

## IM API

### node 会员的在线状态

#### 调用接口

    emit('get_state', u_list);

#### 请求参数

- u_list 会员列表
- u_id 会员编号

#### 返回数据

    emit('get_state', list);

- list['u_state'] 状态列表
  - u_id 会员编号， 在线时是1，不在线是0
- list['user'] 会员列表
  - u_id 会员编号
  - u_name 会员名
  - avatar 会员头像
  - s_id 店铺编号
  - s_name 店铺名
  - s_avatar 店铺头像
  - online 在线时是1，不在线是0

### node 更新会员状态

#### 调用接口

    emit('update_user', user);

#### 请求参数

- user 会员信息
  - u_id 会员编号
  - u_name 会员名
  - avatar 会员头像
  - s_id 店铺编号
  - s_name 店铺名
  - s_avatar 店铺头像

#### 返回数据

    emit('get_msg', msg_list);

- msg_list 消息列表
  - m_id 消息编号
  - f_id 发消息会员编号
  - f_name 发消息会员名
  - t_id 接收消息编号
  - t_name 接收消息会员名
  - t_msg 消息
  - add_time 发消息时间
  - user 发消息人的会员信息，可能为空

### node 发消息

#### 调用接口

    emit('send_msg', t_msg);

#### 请求参数

- msg 消息
  - f_id 发消息会员编号
  - f_name 发消息会员名
  - t_id 接收消息编号
  - t_name 接收消息会员名
  - t_msg 消息
  - m_id 消息编号
  - add_time 发消息时间
  - goods_id 是含商品地址时为商品编号，不是时为0
  - goods_info 是含商品地址时为商品信息，不是时为空数组
  - chat_goods 商品信息，可为空

#### 返回数据

    emit('get_msg', msg_list);

- msg_list 消息列表
  - m_id 消息编号
  - f_id 发消息会员编号
  - f_name 发消息会员名
  - t_id 接收消息编号
  - t_name 接收消息会员名
  - t_msg 消息
  - add_time 发消息时间
  - user 发消息人的会员信息，可能为空

### node 删除消息

#### 调用接口

    socket.emit('del_msg', {'max_id':max_id,'f_id':u_id});

#### 请求参数

- max_id 已读的最大消息编号
- f_id 消息发送人的会员编号

#### 返回数据

    emit('del_msg', msg);

- msg 消息
- max_id 已读的最大消息编号
- f_id 消息发送人的会员编号

### 会员聊天--node连接参数

#### 调用接口(get)

    index.php?app=member_chat&feiwa=get_node_info

#### 请求参数

- key 当前登录令牌
- u_id 聊天对象的会员编号，可为空
- chat_goods_id 商品页面的商品编号，可为空

#### 返回数据

- node_chat 是否开启聊天功能，开是为true
- node_site_url node服务器网址
- resource_site_url 引用资源地址
- member_info 登录会员信息
  - member_id 会员编号
  - member_name 会员名
  - member_avatar 会员头像
  - store_name 店铺名
  - grade_id 店铺等级
  - store_id 店铺编号
  - seller_name 店铺登录名
  - store_avatar 店铺头像
- user_info 聊天对象的会员信息，可为空，结构与member_info相同
- chat_goods 商品信息，可为空

### 会员聊天--最近联系人列表

#### 调用接口(post)

    index.php?app=member_chat&feiwa=get_user_list

#### 请求参数

- key 当前登录令牌
- n 查询会员数量，可为空，默认为50个
- recent 会员类型，可为空，为1时只显示最近联系人，否则包括好友

#### 返回数据

- node_info node信息
  - node_chat 是否开启聊天功能，开是为true
  - node_site_url node服务器网址
- member_info 登录会员信息
  - member_id 会员编号
  - member_name 会员名
  - member_avatar 会员头像
  - store_name 店铺名
  - grade_id 店铺等级
  - store_id 店铺编号
  - seller_name 店铺登录名
  - store_avatar 店铺头像
- list 会员列表
  - u_id 会员编号
  - u_name 会员名
  - avatar 会员头像
  - friend 是好友时为1，不是时无此字段
  - recent 是最近联系人为1，不是时无此字段
  - time 是最近联系人为会话时间，不是时无此字段
  - m_id 是最近联系人为消息编号，不是时无此字段
  - t_msg 是最近联系人为消息内容，不是时无此字段
  - r_state 是最近联系人为消息状态:1为已读,2为未读，不是时无此字段

### 会员聊天--会员信息

#### 调用接口(post)

    index.php?app=member_chat&feiwa=get_info

#### 请求参数

- key 当前登录令牌
- u_id 会员编号
- t 查询类型('member_id','member_name','store_id','member')

#### 返回数据

- member_info 会员
  - member_id 会员编号
  - member_name 会员名
  - member_avatar 会员头像
  - store_name 店铺名
  - grade_id 店铺等级
  - store_id 店铺编号
  - seller_name 店铺登录名
  - store_avatar 店铺头像

### 会员聊天--发消息

#### 调用接口(post)

    index.php?app=member_chat&feiwa=send_msg

#### 请求参数

- key 当前登录令牌
- t_id 接收消息会员编号
- t_name 接收消息会员帐号
- t_msg 消息
- chat_goods_id 商品页面的商品编号，可为空

#### 返回数据

- msg 消息
  - f_id 发消息会员编号
  - f_name 发消息会员名
  - t_id 接收消息编号
  - t_name 接收消息会员名
  - t_msg 消息
  - m_id 消息编号
  - f_ip 发消息IP
  - r_state 消息状态，已读是1，未读是2
  - add_time 发消息时间
  - goods_id 是含商品地址时为商品编号，不是时为0
  - goods_info 是含商品地址时为商品信息，不是时为空数组
  - chat_goods 商品信息，可为空（结构如index.php?app=member_chat&feiwa=get_goods_info）

### 会员聊天--商品信息

#### 调用接口(post)

    index.php?app=member_chat&feiwa=get_goods_info

#### 请求参数

- key 当前登录令牌
- goods_id 商品编号

#### 返回数据

- goods 商品
  - goods_id 商品编号
  - store_id 店铺编号
  - goods_commonid 商品公共编号
  - goods_name 商品名
  - goods_image 商品主图
  - goods_price 商品价格
  - goods_marketprice 市场价
  - goods_promotion_price 商品促销价格
  - url 商品网址
  - pic 商品主图网址
  - pic24 商品图，240px
  - pic36 商品图，360px

### 会员聊天--聊天记录查询

#### 调用接口(post)

    index.php?app=member_chat&feiwa=get_chat_log

#### 请求参数

- key 当前登录令牌
- t_id 接收消息会员编号
- t 查询天数('7','15','30')
- page 每页显示数量，可为空，默认为5个
- curpage 当前页码

#### 返回数据

- list 消息列表
  - m_id 消息编号
  - f_id 发消息会员编号
  - f_name 发消息会员名
  - t_id 接收消息编号
  - t_name 接收消息会员名
  - t_msg 消息
  - f_ip 发消息IP
  - time 发消息时间，格式化后的值，“Y-m-d H:i:s”
  - add_time 发消息时间，时间戳形式

### 会员聊天--未读消息数量

#### 调用接口(post)

    index.php?app=member_chat&feiwa=get_msg_count

#### 请求参数

- key 当前登录令牌

#### 返回数据

- 数字 未读消息数量，从0开始

### 会员聊天--删除最近联系人消息

#### 调用接口(post)

    index.php?app=member_chat&feiwa=del_msg

#### 请求参数

- key 当前登录令牌
- t_id 接收消息会员编号

#### 返回数据

- 1

### 我的好友--查询会员

#### 调用接口(post)

    index.php?app=member_snsfriend&feiwa=member_list

#### 请求参数

- key 当前登录令牌
- m_name 会员名

#### 返回数据

- member_list 会员列表
- u_id 会员编号
- u_name 会员名
- truename 真实姓名
- avatar 会员头像

### 我的好友--好友列表

#### 调用接口(post)

    index.php?app=member_snsfriend&feiwa=friend_list

#### 请求参数

- key 当前登录令牌
- page 每页显示数量，可为空，默认为5个
- curpage 当前页码

#### 返回数据

- friend_list 好友列表，结构与“最近联系人列表”接口一样，这个是可分页的
- u_id 会员编号
- u_name 会员名
- avatar 会员头像

### 我的好友--添加好友

#### 调用接口(post)

    index.php?app=member_snsfriend&feiwa=friend_add

#### 请求参数

- key 当前登录令牌
- m_id 会员编号

#### 返回数据

- '1'

### 我的好友--删除好友

#### 调用接口(post)

    index.php?app=member_snsfriend&feiwa=friend_del

#### 请求参数

- key 当前登录令牌
- m_id 会员编号

#### 返回数据

- '1'

## 调用WAP地址

### 用户注册协议

    tmpl/member/document.html

### 找回密码

    tmpl/member/find_password.html

## 微店

### 店铺信息

#### 调用接口(post)

      index.php?app=seller_store&feiwa=store_info

#### 请求参数

- key 当前登录令牌

#### 返回数据

- store_id 店铺ID
- store_name 店铺名字
- grade_id 店铺等级
- member_id 会员id
- member_name 会员名称
- seller_name 店主卖家用户名
- sc_id 店铺分类
- store_company_name 店铺公司名称
- province_id 店铺所在省份ID
- area_info 地区内容
- store_address 详细地区
- store_zip 邮政编码（没用）
- store_state 店铺状态，0关闭，1开启，2审核中
- store_clost_info 店铺关闭原因
- store_time 店铺时间
- store_end_time 店铺关闭时间
- store_label 店铺LOGO
- store_banner 店铺横幅
- store_avatar 店铺头像
- store_keywords 店铺SEO关键字
- store_description 店铺SEO描述
- store_qq QQ
- store_ww 旺旺
- store_phone 商家电话
- store_zy 主营商品

### 编辑店铺

#### 调用接口(post)

      index.php?app=seller_store&feiwa=store_edit

#### 请求参数

- key 当前登录令牌
- store_banner 店铺logo,FILES方式提交
- store_qq 店铺QQ
- store_ww 店铺旺旺
- store_phone 店铺手机号码
- store_zy 店铺主营
- seo_keywords SEO关键词
- seo_description SEO描述

#### 操作成功

    //操作成返回"1"
    {"code":200,"datas":{"1"}}

#### 错误

    //出现错误返回error，error内为错误信息
    {"code":200,"datas":{"error":"参数错误"}}

### 实物结算

#### 调用接口(post)

      index.php?app=seller_bill&feiwa=list

#### 请求参数

- key 当前登录令牌
- page 每页数量
- curpage 当前页码
- ob_no 结算单号（7~14位以20开头的数字）
- bill_state 账单状态 （1 已出账，2商家已确认，3平台已审核，4结算完成）

#### 返回数据

- bill_list[] 结束列表
  - ob_no 结算单号
  - ob_start_date 开始日期
  - ob_end_date 结束日期
  - ob_order_totals 订单金额
  - ob_shipping_totals 运费
  - ob_order_return_totals 退单金额
  - ob_commis_totals 佣金金额
  - ob_commis_return_totals 退还佣金
  - ob_store_cost_totals 店铺促销活动费用
  - ob_result_totals 应结金额
  - ob_create_date 生成结算单日志
  - os_month 结算单年月份
  - ob_state 1 已出账，2商家已确认，3平台已审核，4结算完成
  - ob_pay_date 付款日期
  - ob_pay_content 支付备注
  - ob_store_id 店铺ID
  - ob_store_name 店铺名称
  - ob_order_book_totals 被关闭的预订订单的实收总金额

### 虚拟结算

#### 调用接口(post)

      index.php?app=seller_vr_bill&feiwa=list

#### 请求参数

- key 当前登录令牌
- page 每页数量
- curpage 当前页码
- ob_no 结算单号（7~14位以20开头的数字）
- bill_state 账单状态 （1 已出账，2商家已确认，3平台已审核，4结算完成）

#### 返回数据

- bill_list[] 结束列表
  - ob_no 结算单号
  - ob_start_date 开始日期
  - ob_end_date 结束日期
  - ob_order_totals 订单金额
  - ob_commis_totals 佣金金额
  - ob_result_totals 应结金额
  - ob_create_date 生成结算单日志
  - os_month 结算单年月份
  - ob_state 1 已出账，2商家已确认，3平台已审核，4结算完成
  - ob_pay_date 付款日期
  - ob_pay_content 支付备注
  - ob_store_id 店铺ID
  - ob_store_name 店铺名称

### 店铺已有客户列表

#### 调用接口(post)

      index.php?app=seller_client&feiwa=list

#### 请求参数

- key 当前登录令牌
- page 每页数量
- curpage 当前页码
- buyer_name 会员账号

#### 返回数据

- member_list[] 客户列表
  - member_id 会员ID
  - member_name 用户名
  - member_avatar 会员头像
  - member_email 邮箱
  - member_mobile 手机号

### 客户购买商品

#### 调用接口(post)

      index.php?app=seller_client&feiwa=list

#### 请求参数

- key 当前登录令牌
- page 每页数量
- curpage 当前页码
- member_id 会员ID

#### 返回数据

- goods_list[] 客户列表
  - store_id 店铺ID
  - goods_name 商品名称
  - goods_image 商品图片
  - goods_num 购买数量
  - goods_price 商品单价
  - order_add_time 下单时间

### 微店主页信息接口

#### 调用接口(post)

      index.php?app=seller_store&feiwa=store_statistics

#### 请求参数

- key 当前登录令牌

#### 返回数据

- store_name 店铺名称
- store_banner 店铺LOGO
- order_amount 本月营收
- order_num 本月订单数
- click_amount 本月访问数

### 店铺销售统计之下单金额接口

#### 调用接口(post)

      index.php?app=seller_stat&feiwa=ordersamount

#### 请求参数

- key 当前登录令牌
- stattype 统计方式，'yesterday'表示昨天，'day3'表示最近3天，'day7'表示最近7天，'week'表示本周，'month'表示本月，'year'表示本年

#### 返回数据

- x 横坐标数组
- y 纵坐标数组

### 店铺销售统计之下单量接口

#### 调用接口(post)

      index.php?app=seller_stat&feiwa=ordersnum

#### 请求参数

- key 当前登录令牌
- stattype 统计方式，'yesterday'表示昨天，'day3'表示最近3天，'day7'表示最近7天，'week'表示本周，'month'表示本月，'year'表示本年

#### 返回数据

- x 横坐标数组
- y 纵坐标数组

### 店铺销售统计之客单价分布接口

#### 调用接口(post)

      index.php?app=seller_stat&feiwa=perguestprice

#### 请求参数

- key 当前登录令牌
- stattype 统计方式，'yesterday'表示昨天，'day3'表示最近3天，'day7'表示最近7天，'week'表示本周，'month'表示本月，'year'表示本年

#### 返回数据

- x 横坐标数组
- y 纵坐标数组

### 店铺商品统计之商品下单金额TOP10接口

#### 调用接口(post)

      index.php?app=seller_stat&feiwa=goodsamount

#### 请求参数

- key 当前登录令牌
- stattype 统计方式，'yesterday'表示昨天，'day3'表示最近3天，'day7'表示最近7天，'week'表示本周，'month'表示本月，'year'表示本年

#### 返回数据

- x 横坐标数组
- y 纵坐标数组

### 店铺商品统计之商品下单量TOP10接口

#### 调用接口(post)

      index.php?app=seller_stat&feiwa=goodsnum

#### 请求参数

- key 当前登录令牌
- stattype 统计方式，'yesterday'表示昨天，'day3'表示最近3天，'day7'表示最近7天，'week'表示本周，'month'表示本月，'year'表示本年

#### 返回数据

- x 横坐标数组
- y 纵坐标数组

### 店铺商品统计之商品流量TOP10接口

#### 调用接口(post)

      index.php?app=seller_stat&feiwa=goodsflow

#### 请求参数

- key 当前登录令牌
- stattype 统计方式，'yesterday'表示昨天，'day3'表示最近3天，'day7'表示最近7天，'week'表示本周，'month'表示本月，'year'表示本年

#### 返回数据

- x 横坐标数组
- y 纵坐标数组

### 店铺区域统计之区域下单金额TOP10接口

#### 调用接口(post)

      index.php?app=seller_stat&feiwa=areasalesamount

#### 请求参数

- key 当前登录令牌
- stattype 统计方式，'yesterday'表示昨天，'day3'表示最近3天，'day7'表示最近7天，'week'表示本周，'month'表示本月，'year'表示本年

#### 返回数据

- x 横坐标数组
- y 纵坐标数组

### 店铺区域统计之区域下单量TOP10接口

#### 调用接口(post)

      index.php?app=seller_stat&feiwa=areasalesnum

#### 请求参数

- key 当前登录令牌
- stattype 统计方式，'yesterday'表示昨天，'day3'表示最近3天，'day7'表示最近7天，'week'表示本周，'month'表示本月，'year'表示本年

#### 返回数据

- x 横坐标数组
- y 纵坐标数组

### 店铺区域统计之区域下单会员数TOP10接口

#### 调用接口(post)

      index.php?app=seller_stat&feiwa=areamembernum

#### 请求参数

- key 当前登录令牌
- stattype 统计方式，'yesterday'表示昨天，'day3'表示最近3天，'day7'表示最近7天，'week'表示本周，'month'表示本月，'year'表示本年

#### 返回数据

- x 横坐标数组
- y 纵坐标数组