You need to enable JavaScript to run this app.
导航

wap注册

最近更新时间2023.03.09 17:38:22

首次发布时间2021.10.18 11:12:18

wap注册接口主要用于生成用户唯一标识,该标识将用于火山引擎侧的推荐系统,进行个性化推荐。

注意

  1. 推荐系统根据AccessToken进行个性化推荐。
  2. 用户安全:不使用用户的明文信息,保护用户信息不泄露。
  3. AccessToken有效期较长,目前为60天左右,建议客户侧研发把AccessToken缓存起来。
  4. 当AccessToken过期时或无效时,接口返回值中将出现error。此时需要重新使用注册接口获取AccessToken。
  5. 不要使用同一个uuid并发请求注册,否则返回错误。
  6. 同一个用户uuid要保证唯一且不变,不同用户不可共用同一个uuid,否则将影响推荐效果。

请求方式

请求方法

GET/POST(Content-Type: application/x-www-form-urlencoded)

请求url

https://mercury.volcengineapi.com/?Action=WapRegister&Version=2021-01-01

请求header

ServiceName:content

请求参数

参数描述类型是否必填说明
Partner渠道号String登录火山引擎内容定制控制台-应用管理-查看详情,查找对应“渠道号“

Uuid

客户侧用户ID

String

客户侧用户唯一标识,如设备标识或客户侧自有的账号体系,比如用户邮箱、imei、mac地址、自增id等,也可以是加密的id等,长度不超过64。注意:本参数需要参与签名

Ouid

客户侧登录用户ID

String

同一个设备上用户由非登陆变为登陆态,需要使用相同的Uuid绑定此Ouid进行注册请求;以后每次请求注册都需要同时传入Uuid+Ouid,否则会被认为退出登陆,变成新用户

Age年龄int年龄,0~100的数字
Gender性别String女:f,男:m
Birth出生年份int比如1993

响应参数

除了“公共参数”外,Result结构

参数
描述
类型
说明
Result
响应结果
Result
用户信息

请求示例

public static void main(String[] args) {
        //初始化一个service
        StreamService streamService = StreamServiceImpl.getInstance();
        //设置ak,sk 此为请求的凭证
        streamService.setAccessKey("xxx");
        streamService.setSecretKey("xxx");
        //初始化Request
        WapRegisterRequest req = new WapRegisterRequest();
        req.setPartner("xxx");
        req.setUuid("001");
        req.setOuid("xxx");      
        try {
            WapRegisterResponse response = streamService.wapRegister(req);            System.out.println(JSON.toJSONString(response));
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

响应示例

{
    "ResponseMetadata":{
        "Action":"WapRegister",
        "Region":"cn-north-1", "RequestId":"02163395307446300000000000000000000ffff0aca5d1d2c01cd",
        "Service":"content",
        "Version":"2021-01-01"
    },
    "Result":{
        "AccessToken":"xxx",
        "ExpiresIn":5184000
    }
}