Skip to main content

【聚合类】创建用户及会员

基本信息

接口名称:* 聚合创建用户(手机号自动创建会员)状  态:已完成
接口路径:POST /paas/micro/member/apiCreateGuest更新时间:2022-03-09 19:46:45
Mock地址:https://apimock.e-buychina.com/mock/49/paas/micro/member/apiCreateGuest

请求参数

Headers:

参数名称参数值是否必填
Content-Typeapplication/json

Body:

参数名称类型必填默认值备注其他信息
uuidstring请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
appIdstring请求AppId(租户应用ID、对接应用ID)最大长度:50
最小长度:1
Mock:@natural
actionstring交易类型最大长度:50
最小长度:1
Mock:apiCreateGuest
timestampnumber请求时间戳Mock:@timestamp
signTypestringsha256签名类型最大长度:20
最小长度:1
Mock:sha256
signstring签名值最大长度:500
最小长度:1
Mock:@natural
langstringzh_CN语言最大长度:50
最小长度:1
Mock:zh_CN
contentobject请求报文
  openIdstring微信、银联openId、支付宝userId、H5手机号最大长度:50
最小长度:1
Mock:@string
  clientTypestringH5客户端类型(默认:H5,微信小程序:WechatMiniProgram,微信公众号:WechatMediaPlatform,支付宝小程序:AlipayTinyApp,云闪付小程序:UnionPayMiniProgram)最大长度:20
最小长度:1
Mock:@string
  phoneNumberstring手机号最大长度:50
最小长度:1
Mock:@string
  thirdAppIdstring渠道方应用ID(微信、支付宝)小程序
公众号appid,仅H5可上送对接租户应用ID(线下场景可需上送"")
最大长度:50
最小长度:1
Mock:@string
  unionIdstring渠道主体用户ID(例如微信开放平台unionId)最大长度:50
Mock:@string
  thirdOpenIdstring第三方会员ID(例如天正、有赞、哗啦啦、非码等会员ID)最大长度:50
最小长度:1
Mock:@string
  guestSourcestring用户来源(按实际业务场景填写)最大长度:50
最小长度:1
Mock:@string
  guestExtendInfoobject用户其他信息
    photoUrlstring头像地址最大长度:100
最小长度:1
Mock:@string
    genderstringUnknown性别:Male、Female、Unknown最大长度:10
最小长度:1
Mock:@string
    nicknamestring昵称最大长度:50
最小长度:1
Mock:@string
    emailstring邮箱最大长度:30
最小长度:1
Mock:@string
    countrystring国家最大长度:32
最小长度:1
Mock:@string
    provincestring最大长度:32
最小长度:1
Mock:@string
    citystring最大长度:32
最小长度:1
Mock:@string

返回数据

参数名称类型必填默认值备注其他信息
uuidstring请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
successboolean交易成功与否Mock:@boolean
actionstring交易类型最大长度:50
最小长度:1
Mock:apiCreateGuest
timestampnumber返回时间戳Mock:@timestamp
errorCodestring错误码最大长度:50
Mock:@word
errorMessagestring错误描述最大长度:50
Mock:@csentence
signTypestring签名类型最大长度:20
Mock:sha256
signstring签名值最大长度:500
Mock:@natural
contentobject返回报文
  guestIdstring用户标识ID(租户应用渠道应用唯一)最大长度:32
最小长度:1
Mock:@word
  memberIdstringPAAS会员ID(有手机号时必有返回值)最大长度:32
最小长度:1
  ebuyMemberIdstring易百会员ID(有手机号时必有返回值)最大长度:32
最小长度:1
  platformIdstring渠道平台ID(微信ID、支付宝ID)最大长度:32
最小长度:1

备注

业务场景介绍

1)对接第三方创建用户接口的增量及更新信息接口(含批量)
2)提供外部供应商通过gateway进行用户信息对接(收银台快速创建用户及会员)
3)openId识别手机号格式判断,异步自动创建租户会员

接口调用重要说明:
* 单个应用内相同openId调用接口已经幂等处理,有且仅有一条用户记录(租户会员记录一条),多次调用将执行更新用户拓展信息操作
* 同租户下不同应用相同openId调用接口,会产生新的用户记录(租户会员记录保持一条)
* 不同租户下不同应用相同openId调用接口,会员多条用户记录(租户会员记录会有多条)

变更历史

变更日期变更内容
2022-03-09
2021-07-09
2021-07-09
2021-07-09
2021-07-09
2021-07-07
2021-07-07
2021-07-07
2021-07-07
2021-07-07
2021-07-07
2021-07-07
2021-07-07
2021-07-07
api-id=31722