You need to enable JavaScript to run this app.
导航
内容定制
  • 文档首页
    • /
  • 内容定制

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

注意

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

请求参数

参数描述类型是否必填说明
uuid客户侧用户IDString是客户侧用户唯一标识，如设备标识或客户侧自有的账号体系，比如用户邮箱、imei、mac地址、自增id等，也可以是加密的id等，长度不超过64。注意：本参数需要参与签名
ouid客户侧登录用户IDString否同一个设备上用户由非登陆变为登陆态，需要使用相同的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"
}