应用服务批量回传用户信息

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


请求

域名

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

uri

/api/v1/server/user/passback_user_info_batch

请求方法

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

header参数

query参数

名称 类型 说明 是否必填 默认
tenant_code string 租户代码 -
app_key string 服务端应用key -
channel string 渠道码。由B2C平台分配。 -
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_infos string 用户信息。{key:value}形式json化字符串,仅支持两层。如果未传union_id,则其中子数组必须包含唯一标识键。特殊键名见下述 -

响应 json.data

名称 类型 说明
union_ids array 用户ID组

示例1

请求

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

BODY
{
  "user_infos": "[{\"ydxs_id\":\"oPs3420sei\",\"age\":28,\"sex\":\"male\"}]",
  "primaray_key": "ydxs_id"
}

响应

{
    "code":200,
    "msg":"ok",
    "data":{
        "union_ids":[
            "u002"
        ]
    }
}

注意规避以下键名

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

特殊键名(允许回传)

说明
mobile 手机号
mobile_district_code 手机号国际区号
id_card 身份证号
password 登录密码
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 ""