文档

​
​

Development

User Acquisition

Monetization

工业

Unity Offerwall

Offerwall Android SDK

Offerwall iOS SDK

Offerwall Unity SDK

Unity Offerwall

Tapjoy Offerwall
​
​
开始使用
  • 访问 Tapjoy Offerwall 变现后台
  • 开始使用 Offerwall
  • 在 Unity Ads 中推广 Offerwall
  • 应用设置
Dashboard(后台)
  • AB 测试
  • 货币促销
  • 兑换比例
  • 消息
  • Offerwall 卡片
  • 广告位
  • 发行商客户服务工具
  • 定向投放
  • 指标参考
优化
  • 变现策略规划
API
  • API 身份验证
  • Reporting API 发行商
  • Reporting API 最佳实践
  • 内容管理
  • 用户级收入 API 概述
虚拟货币
  • 虚拟货币概述
  • 自管货币
  • Tapjoy 托管货币
  • 回调故障故障排除
其他
  • Offerwall Monetization(变现)后台用户角色和权限
  • 故障排除
  • 应用隐私 - iOS
  • 数据安全 - Android
  • 常见问题解答
  1. 实现游戏增长
  2. Unity Offerwall
  3. Offerwall 变现

API 身份验证

使用 Tapjoy Offerwall API 时对 API 请求进行身份验证,从而获得授权访问权限来管理用户参与度和变现数据。
阅读时间3 分钟
最后更新于 2 天前

申请资格

这些请求通过标准的双边 OAuth2 流程完成身份验证:先用编码后的 API 密钥来请求
access_token
,然后用获得的
access_token
对后续请求进行身份验证。
您可以在 LTV 后台中选择 App(应用)> Settings(设置)> App Settings(应用设置)> 向下滚动 > API Keys(API 密钥)找到 API 密钥。
在 Offerwall(提供墙)后台中显示的营销 API 密钥。
访问令牌的有效生命周期为 1 小时,无法刷新。当令牌到期时,必须使用 Reporting API 密钥/Marketing API 密钥来请求新的令牌。
要请求访问令牌,必须使用 API 密钥发送带有 Authorization 标头的 POST 请求。如果凭据有效,则响应中将包含一个访问令牌以及令牌到期时间(以秒为单位)。

请求示例

以下示例展示了如何使用原始 HTTP、curl 和 Ruby 来请求访问令牌。
POST /v1/oauth2/token Host: api.tapjoy.com Authorization: Basic <API Key>Accept: application/json
curl -H "Authorization: Basic <API Key>" -X POST https://api.tapjoy.com/v1/oauth2/token
require 'json'require 'net/https'access_token = "<OAuth Token>"query = <<~ENDquery { user { firstName }}ENDjson = JSON.dump({query: query})http = Net::HTTP.new('api.tapjoy.com', 443)http.use_ssl = truerequest = Net::HTTP::Post.new('/graphql')request['Authorization'] = "Bearer #{access_token}"request.body = jsonresponse = http.request(request)result = JSON.parse(response.body)data = result['data']errors = result['errors']

成功响应

成功请求返回 200 状态,其中包含访问令牌及其过期持续时间(以秒为单位)。
status 200 { "access_token": "token_string","token_type": "bearer","expires_in":3600,"refresh_token": null }

响应不成功

如果 API 密钥无效或缺失,则请求返回 401 状态。
status 401{ "error":"Unauthorized" }

使用访问令牌

获得
access_token
后,即可向 API 发出请求。每个
access_token
都需要在 Authorization 标头中包含“Bearer”类型的 。如果
access_token
已过期或不存在,则响应的状态将是 401 Unauthorized(未经授权)。

请求示例

以下示例显示了经过身份验证的 API 请求所需的标头。
POST /v4/audiences Host: api.tapjoy.com Authorization: Bearer <token_string> Accept: application/json

令牌缺失或无效令牌响应

如果访问令牌丢失或已过期,则请求返回 401 状态。
status 401 { "error":"Unauthorized" }

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。

  • 在本页上
    • 申请资格

      • 请求示例

      • 成功响应

      • 响应不成功

    • 使用访问令牌

      • 请求示例

      • 令牌缺失或无效令牌响应


报告此页面的问题