API 身份验证

使用 Tapjoy Offerwall API 时对 API 请求进行身份验证，从而获得授权访问权限来管理用户参与度和变现数据。

阅读时间1 分钟

最后更新于 2 个月前

请求访问权限

这些请求通过标准的双边 OAuth2 流程完成身份验证：先用编码后的 API 密钥来请求

access_token

，然后用获得的

access_token

对后续请求进行身份验证。您可以在 LTV 后台中选择 App（应用）> Settings（设置）> App Settings（应用设置）> 向下滚动 > API Keys（API 密钥）找到 API 密钥。

访问令牌的有效生命周期为 1 小时，无法刷新。当令牌到期后，必须使用 Reporting API 密钥/Marketing API 密钥来请求新的令牌。要请求访问令牌，必须使用 API 密钥发送带有 Authorization 标头的 POST 请求。如果凭据有效，则响应中将包含一个访问令牌以及令牌到期时间（以秒为单位）。 请求示例


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']

成功响应


status 200 { “access_token”: “token_string”,“token_type”: “bearer”,“expires_in”: 3600,“refresh_token”: null }

失败响应


status 401{ “error”: “Unauthorized” }

使用访问令牌

获得

access_token

后，即可向 API 发出请求。每个请求都需要在 Authorization 标头中包含“Bearer”类型的

access_token

。如果

access_token

已过期或不存在，则响应的状态将是 401 Unauthorized（未经授权）。 请求示例


POST /v4/audiences Host: api.tapjoy.com Authorization: Bearer <token_string> Accept: application/json

令牌缺失/无效令牌响应


status 401 { “error”: “Unauthorized” }

文档

引擎

服务

增长

工业

支持

Offerwall

开始使用 Monetization（变现）

开始使用 User Acquisition

Unity SDK 集成

Offerwall

API 身份验证

请求访问权限

使用访问令牌