sffi/member-plug

A project for Company Member Center

v0.1.50 2022-11-17 09:58 UTC

README

2021-01-13 完善第三方信息查询接口

2020-08-06 新增添加第三方信息接口

2020-07-09 新增批量查询接口

$res = \sffi\Factory::Member()->batchQuery([
        'username' => '188',
        ['level', '>', 2]
    ]);

添加配置文件member.php位于根目录下extend目录里

return [
    'baseurl'   =>  'baseurl',
    'request_key'       =>  'key'
];

例子:调用资产查询

\sffi\Factory::Assets('http://YOU.DOMAIN.PATH','PLEASE INPUT YOU KEY')->query(1,'rmb');

文档如下:

会员中心

本项目为内部项目,仅供公司内部调用。

本项目调用需授权,需要先在数据库platform_key表中添加一条唯一key的数据,并将KEY值交由下游系统在请求头中携带【PLATFORM-KEY】使用。否则将提示未授权访问。

本系统由用户管理于积分管理两大部分组成。

【api】用户/member

修改用户信息

基本信息

Path: /member/update

Method: POST

接口描述:

此接口可以修改用户所有信息,
修改证件信息需要传递Card数组
修改用户昵称等信息需要传递Info数组
修改用户密码等级等信息,需要传递member数组

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json

Body

名称类型是否必须默认值备注其他信息
idnumber必须用户ID
memberobject非必须会员基本信息
├─ passwordstring非必须密码
├─ levelnumber非必须等级
├─ tagsstring []非必须标签

item 类型: string

├─ 非必须
infoobject非必须会员信息
├─ nicknamestring非必须昵称
├─ head_imgstring非必须头像
├─ sexnumber非必须性别
cardobject非必须会员证件信息
├─ idcard_nostring非必须证件号
├─ true_namestring非必须真实姓名
├─ idcard_font_urlstring非必须证件照国徽面路径
├─ idcard_back_urlstring非必须证件照人像面路径
├─ idcard_auth_video_urlstring非必须认证视频路径
thirdobject必须第三方信息
├─ nicknamestring必须昵称
├─ open_idstring必须第三方会员ID
├─ head_img_urlstring必须头像路径
├─ provincestring必须省份
├─ citystring必须市区
├─ countrystring必须国家
├─ unionidstring必须唯一识别码
├─ typestring必须第三方类型 wx-gzh微信公众号 wx-xcx微信小程序 ali阿里 wb微博 dy抖音

返回数据

名称类型是否必须默认值备注其他信息
datastring []非必须

item 类型: string

├─ 非必须
msgstring非必须
codenumber非必须

查询

基本信息

Path: /member/query

Method: POST

接口描述:

此接口在存在用户名查询时,仅查询用户信息,ID和type不生效。

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json

Body

名称类型是否必须默认值备注其他信息
idstring非必须用户ID

mock: 1

typestring []非必须可为字符串,或者数组 字符串仅查询单个内容,数组可以查询多个内容

item 类型: string

├─ 非必须info用户昵称头像信息 card用户证件信息 third用户第三方信息 //top常用联系人信息 暂未实现
usernamestring非必须用户名查询单个用户,优先查询此方法

返回数据

名称类型是否必须默认值备注其他信息
dataobject非必须如果为对象则为用户信息 如果为数字则表示用户ID 如果为false则表示用户不存在
├─ memberobject非必须用户信息
├─ idnumber非必须
├─ usernamestring非必须
├─ levelnumber非必须
├─ tagsstring []非必须

item 类型: string

├─ 非必须
├─ statusnumber非必须
├─ infoobject非必须用户基本信息
├─ member_idnumber非必须
├─ sexnumber非必须
├─ head_imgstring非必须
├─ nicknamestring非必须
├─ provincenull非必须
├─ citynull非必须
├─ districtnull非必须
├─ cardobject非必须用户证件信息
├─ idnumber非必须
├─ idcard_nostring非必须
├─ true_namestring非必须
├─ idcard_typenumber非必须
├─ idcard_font_urlstring非必须
├─ idcard_back_urlstring非必须
├─ idcard_auth_video_urlstring非必须
├─ idcard_auth_video_timenull非必须
├─ auth_statusnumber非必须
├─ thirdobject非必须暂未实现
msgstring非必须
codenumber非必须

注册新用户

基本信息

Path: /member/registe

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded

Body

参数名称 参数类型 是否必须 示例 备注
username text 18800000000 用户账号
password text e10adc3949ba59abbe56e057f20f883e md5后的密码

返回数据

名称类型是否必须默认值备注其他信息
dataobject非必须详细数据
├─ idnumber非必须
├─ usernamestring非必须
├─ levelnumber非必须用户等级
├─ tagsstring []非必须用户标签

item 类型: string

├─ 非必须
├─ statusnumber非必须
msgstring必须提示信息
codenumber必须提示编码

验证用户密码

基本信息

Path: /member/valid

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded

Body

参数名称 参数类型 是否必须 示例 备注
username text 18800000001 用户账号
password text e10adc3949ba59abbe56e057f20f883e 用户密码 需MD5

返回数据

名称类型是否必须默认值备注其他信息
dataobject非必须
├─ idnumber非必须用户ID
├─ usernamestring非必须用户账号
├─ level_idnumber非必须用户等级
├─ tag_idsstring非必须用户标签
├─ statusnumber非必须用户状态
msgstring非必须
codenumber非必须

【api】证件信息/Idcard

新增入住证件

基本信息

Path: /idcard/createCard

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded

Body

参数名称 参数类型 是否必须 示例 备注
idcard_no text 430902199100000000
true_name text 余*

返回数据

申请认证

基本信息

Path: /idcard/applyAuth

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded

Body

参数名称 参数类型 是否必须 示例 备注
id text 1 用户ID
card_id text 1 证件ID

返回数据

认证结果查询

基本信息

Path: /idcard/query

Method: GET

接口描述:

本接口仅支持单参数查询,仅支持会员主键或证件主键查询。
即,id和card_id仅支持一个参数。

请求参数

Query

参数名称 是否必须 示例 备注
id 1 用户ID
card_id 8 证件ID

返回数据

跳转路径

基本信息

Path: /idcard/toRedirect

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
token 9VF2M04ESaqw/iTDlrodQVJ4Q16mM/Sg

【api】资产类型/assetsType

冻结用户资产

基本信息

Path: /assets_type/frozenAssetsType

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
id 1 用户ID
assetsType rmb 资产类型编码 不传表示冻结所有资产

返回数据

名称类型是否必须默认值备注其他信息
datastring []非必须

item 类型: string

├─ 非必须
msgstring必须
codenumber必须

新增用户资产类型

基本信息

Path: /assets_type/addAssetsType

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
id 1 用户ID
assetsType rmb 资产类型编码

返回数据

名称类型是否必须默认值备注其他信息
dataobject非必须
├─ score_typestring必须资产类型编码
├─ member_idstring必须会员ID
├─ statusnumber非必须资产状态
├─ idstring必须资产ID
msgstring必须
codenumber必须

【api】资产/assets

充值

基本信息

Path: /assets/recharge

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded

Body

参数名称 参数类型 是否必须 示例 备注
id text 1
assetsType text rmb
assets text 40
orderId text

返回数据

名称类型是否必须默认值备注其他信息
datastring []非必须

item 类型: string

├─ 非必须
msgstring必须
codenumber必须

冻结部分资产

基本信息

Path: /assets/frozen

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded

Body

参数名称 参数类型 是否必须 示例 备注
id text 用户ID
assetsType text 资产类型编码
assets text 资产数量 单位分
orderId text 订单ID

返回数据

批量查询

基本信息

Path: /assets/batchQuery

Method: GET

接口描述:

此接口返回结果文档同query接口文档

请求参数

Query

参数名称 是否必须 示例 备注
id 1
assetsTypes[] rmb 资产类型编号 可传多个
startTime 2020-06-27 16:30:00 开始时间
endTime 2020-06-28 16:30:00 结束时间

返回数据

名称类型是否必须默认值备注其他信息
dataobject []非必须

item 类型: object

├─ idnumber必须

mock: 1

├─ member_idnumber必须

mock: 1

├─ score_typestring必须
├─ scorenumber必须
├─ create_timestring必须
├─ order_idstring必须
├─ statusnumber必须
├─ typenumber必须
msgstring非必须
codenumber非必须

查询

基本信息

Path: /assets/query

Method: POST

接口描述:

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/x-www-form-urlencoded

Body

参数名称 参数类型 是否必须 示例 备注
id text 用户ID
assetsType text 资产类型编号
startTime text 开始时间
endTime text 结束时间

返回数据

名称类型是否必须默认值备注其他信息
dataobject []非必须

item 类型: object

├─ idnumber必须
├─ member_idnumber必须用户ID
├─ score_typestring必须资产类型编号
├─ scorenumber必须资产数量 单位分
├─ create_timestring必须
├─ order_idstring必须订单号
├─ statusnumber非必须
├─ typenumber必须收支类型 1收入 2支出
msgstring非必须
codenumber非必须

消费

基本信息

Path: /assets/consume

Method: GET

接口描述:

请求参数

Query

参数名称 是否必须 示例 备注
id 1 用户ID
assetsType rmb 资产类型编码
assets 5 资产数量 单位:分
orderId order_1025510147 订单号

返回数据

【api】用户信息/info

查询

基本信息

Path: /info/query

Method: POST

接口描述:

查询数据可以为此结构
[["nickname","=","鱼子"]]

也可以为
{
    "nickname": "鱼子"
}
此结构



返回数据如下:
{ "data": [ { "member_id": 29, "sex": 2, "head_img": "/uploads/20191016/a26a0178d78b3f2d6f23b54adedb6e64.png", "nickname": "19174", "province": null, "city": null, "district": null }, { "member_id": 32, "sex": 2, "head_img": "/uploads/20191016/a26a0178d78b3f2d6f23b54adedb6e64.png", "nickname": "11156", "province": null, "city": null, "district": null } ], "msg": "成功", "code": 1 }

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json

Body

名称类型是否必须默认值备注其他信息
nicknamestring非必须

返回数据

名称类型是否必须默认值备注其他信息
dataobject []非必须

item 类型: object

├─ member_idnumber必须
├─ sexnumber必须
├─ head_imgstring必须
├─ nicknamestring必须
├─ provincenull必须
├─ citynull必须
├─ districtnull必须
msgstring非必须
codenumber非必须