wap注册--内容定制-火山引擎

文档中心

导航

wap注册

最近更新时间：2023.03.09 17:38:22首次发布时间：2021.04.09 18:31:34

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

请求结构	说明
请求域名	stream-api.feedcoopapi.com【建议】 mercury.snssdk.com【废弃】
请求地址	/access_token/register/wap/v4/
请求协议	HTTP/HTTPS
请求方式	GET/POST
参数类型	application/x-www-form-urlencoded

注意

推荐系统根据access_token进行个性化推荐。
用户安全：不使用用户的明文信息，保护用户信息不泄露。
access_token有效期较长，目前为60天左右，建议合作方把access_token缓存起来。
当access_token过期时或无效时，接口返回值中 ret将为1。此时需要重新使用注册接口获取access_token。
不要使用同一个uuid并发请求注册，否则返回注册失败。
同一个用户uuid要保证唯一且不变，不同用户不可共用同一个uuid，否则将影响推荐效果。

请求参数

参数	描述	类型	是否必填	说明
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

响应参数

参数	描述	类型	说明
ret	响应结果	long	参见“错误码”说明
msg	本次请求是否成功	String	success：成功
message	响应说明	String	历史遗留字段，可忽略
req_id	本次请求标识	String	火山引擎侧使用该字段进行具体问题追踪和排查
data	用户数据	JSONObject

请求示例

curl --location --request GET 'https://stream-api.feedcoopapi.com/access_token/register/wap/v4/?signature=xxx&timestamp=1656048140&nonce=894038&partner=xxx&uuid=xxx'

响应示例

{
    "ret": 0,
    "msg": "success",
    "message": "success",
    "data": {
        "access_token": "AGDp7e07nCdc4vmzfSVHkmcXYTkSB6rwjDV9Aq1anaPdxLz3UM16Pi8JWJxPh6ejxsoydiP62",
        "expires_in": 5184000
    },
    "req_id": "20220624133807010208065051105CE29E"
}