会员/员工(注册/更新)

POST

/ma-open-api/app-api/member/addFiled

最后修改时间：2025-07-11 02:08:06

接口描述

员工/会员注册对外标准接口(如果手机号相同, 则更新员工/会员信息)
接口返回 code=0 表示注册/更新成功，code非0 表示接口调用失败

请求参数说明

通用参数 access_token （使用鉴权模块-获取token接口获取）

返回码说明

参数名称	说明
0	成功
41018	缺少mobile参数
41131	手机号格式错误
41129	请选择身份
41157	身份不存在
41012	缺少svip_source参数

请求参数

Query 参数

access_token

string

必需

示例值:

Body 参数multipart/form-data

mobile

string

手机号

必需

identity

string

必需

身份 1=会员，2=员工

svip_source

string

必需

会员来源 1=注册，7=导入，11=API，4=未知

lead_source

string

可选

标识线索来源 1=注册传入二级来源ID。来源数据通过接口获取： https://www.apifox.cn/apidoc/shared/0f5e5d40-1266-4d0d-8e48-9f269fae6acf/api-282030644

name

string

姓名

可选

openid

string

可选

微信openid（当此值需要传输时，需要对应传输对应公众号的appid，进行绑定）

unionid

string

微信unionid

可选

sex

string

可选

性别 1=男，2=女，0=未知

birthday

string

可选

出生日期例：19900101

string

邮箱

可选

province

string

可选

省份id 例: 10161 地区编码表：https://img02.ma.scrmtech.com/2351/1064/resource/1709622780/%E5%9C%B0%E5%8C%BA%E4%BF%A1%E6%81%AF.xlsx

city

string

可选

城市id 例: 100063 地区编码表：https://img02.ma.scrmtech.com/2351/1064/resource/1709622780/%E5%9C%B0%E5%8C%BA%E4%BF%A1%E6%81%AF.xlsx

region

string

地区id 例: 0

可选

address

string

可选

地址例: 测试地址

outlet

string

可选

部门编号（如果身份为员工时，此字段必填）

field_xxx

string

可选

自定义字段支持 field_字段id 传输；下拉多选单选，对应输入选项值，多选用英文逗号拼接（字段id可通过【会员管理-获取自定义字段】接口获取）

appid

string

公众号的appid

可选

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://openapi.beschannels.com/ma-open-api/app-api/member/addFiled?access_token=uURA1lnYsBr22I6UYoLZH0s9y3HU2Xsn7UHA4dIDgHN_67Z5EZskh4YMcymD5enS4GGjWpOERwQtug3Y4AGwvbvLB_A3TwKBpb_J4z0MUm6oaNQmqA-3Ef9Q-PHbVPk3' \
--form 'mobile=""' \
--form 'identity=""' \
--form 'svip_source=""' \
--form 'lead_source=""' \
--form 'name=""' \
--form 'openid=""' \
--form 'unionid=""' \
--form 'sex=""' \
--form 'birthday=""' \
--form 'email=""' \
--form 'province=""' \
--form 'city=""' \
--form 'region=""' \
--form 'address=""' \
--form 'outlet=""' \
--form 'field_xxx=""' \
--form 'appid=""'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

msg

string

状态码描述

必需

data

string

会员/员工id

必需

示例

{
    "code": 0,
    "msg": "请求成功",
    "data": "28244843"
}

修改于 2025-07-11 02:08:06

根据会员id或会员手机号获取会员详细信息

根据地区名称查询地区id

会员/员工(注册/更新)

接口描述#

请求参数说明#

返回码说明#

请求参数

示例代码

返回响应

接口描述

请求参数说明

返回码说明