应用服务回传用户信息

该接口由服务端调用，需提前联系云创团队获取调用所需的appkey和appsecret。

请求

域名

  • 测试环境 https://b2c-beta.mypaas.com.cn
  • 生产环境 https://b2c.mypaas.com.cn

uri

/api/v1/server/user/passback_user_info

请求方法

PUT 请以x-www-form-urlencoded方式提交

header参数

无

query参数

名称 类型 说明 是否必填 默认
tenant_code string 租户代码 是 -
app_key string 服务端应用key 是 -
app_sign string 参见app_sign生成规则 是 -
channel string 渠道码。由B2C平台分配。 是 -
random string 随机字符串,长度8-20。 是 -
timestamp int 当前请求unix时间戳,长度10。 是 -
sign string 数据签名,长度32。参见统一接口签名规范 是 -

body参数

名称 类型 说明 是否必填 默认
union_id string 用户ID 否 -
primary_key string 用户信息中唯一标识键名 否。union_id与primary_key二者必传其一，优先union_id -
user_info string 用户信息。key:value形式json化字符串，仅支持一层。如果未传union_id，则其中必须包含唯一标识键。特殊键名见下述 是 -

响应 json.data

名称 类型 说明
union_id string 用户ID

示例1

请求

PUT /api/v1/server/user/passback_user_info?tenant_code=agile&random=wx_test&timestamp=1524463899&sign=0ca175b9c0f726a831d895e269332461&app_key=rghro4390f43&app_sign=eoiwe9GWErggrg23g&channel=b2c_app

BODY
{
  "user_info": "{\"age\":28,\"sex\":\"male\"}",
  "union_id": "u001"
}

响应

{
  "code": 200,
  "msg": "ok",
  "data": {
    "union_id": "u001"
  }
}

示例2

请求

PUT /api/v1/server/user/passback_user_info?tenant_code=agile&random=wx_test&timestamp=1524463899&sign=0ca175b9c0f726a831d895e269332461&app_key=rghro4390f43&app_sign=eoiwe9GWErggrg23g&channel=b2c_app

BODY
{
  "user_info": "{\"ydxs_id\":\"oPs3420sei\",\"age\":28,\"sex\":\"male\"}",
  "primaray_key": "ydxs_id"
}

响应

{
  "code": 200,
  "msg": "ok",
  "data": {
    "union_id": "u002"
  }
}

注意规避以下键名

建议用户信息键名加自定义前缀，以便识别

特殊键名(允许回传)

键 说明
mobile 手机号
mobile_district_code 手机号国际区号
id_card 身份证号
device_token 信鸽推送token
gps 经纬度

保留键名(禁止回传)

  • union_id
  • channel

说明

  • php中如果user_info通过json_encode进行处理，请添加 JSON_UNESCAPED_UNICODE和JSON_UNESCAPED_SLASHES，即json_encode('value',320),以防中文被转义，导致后期无法修复数据。

results matching ""

    No results matching ""