Ruby on Rails集成TikTok API V2用户访问令牌管理遇参数格式错误

我正在将Ruby on Rails应用中的TikTok API集成升级到V2版本的User Access Token Management模块，在使用授权码获取访问令牌时遇到了参数格式错误。

可用的V1代码 #

def access_token_from(code)
    response = RestClient::Request.execute(
      method: :post,
      url: API_V1_BASE_URL + ACCESS_TOKEN_ENDPOINT +
      "?client_key=#{Rails.application.credentials.tiktok_client_key}" +
      "&client_secret=#{Rails.application.credentials.tiktok_client_secret}" +
      "&code=#{code}" +
      '&grant_type=authorization_code'
    )

    JSON.parse(response.body)
end

无法正常工作的V2代码 #

def manage_token_request(grant_type, params)
    url = API_V2_BASE_URL + ACCESS_TOKEN_ENDPOINT
    payload = {
      client_key: CLIENT_KEY,
      client_secret: CLIENT_SECRET,
      grant_type: grant_type
    }
    headers = {
      content_type: "application/x-www-form-urlencoded",
      cache_control: "no-cache",
    }

    if params[:code].present?
      payload.merge({ code: params[:code], redirect_uri: REDIRECT_URI })
    elsif params[:refresh_token].present?
      payload.merge({ refresh_token: params[:refresh_token] })
    end

    RestClient.post url, payload, headers
end

def access_token_from(code)
    response = manage_token_request(:authorization_code, { code: code })

    JSON.parse(response.body)
end

API错误响应 #

{
 "error"=>"invalid_request",
 "error_description"=>"The request parameters are malformed.",
 "log_id"=>"XXXXXXXXXXXXXXX"
}

注意：使用Postman执行相同调用可以正常获取令牌，但调整代码后仍得到相同错误。有没有人做过该TikTok API模块的RoR集成？

问题定位与修复方案 #

• 哈希合并未生效
  Ruby的Hash#merge方法会返回新的哈希对象，不会修改原有payload变量。你的代码仅调用merge却未将结果赋值回payload，导致请求缺少code和redirect_uri参数，这是核心问题。修改如下：

if params[:code].present?
  payload = payload.merge({ code: params[:code], redirect_uri: REDIRECT_URI })
elsif params[:refresh_token].present?
  payload = payload.merge({ refresh_token: params[:refresh_token] })
end

• Grant Type 格式统一
  TikTok API V2要求grant_type为字符串类型，建议直接传入字符串而非Ruby符号，避免潜在编码问题：

# 调用时传入字符串
response = manage_token_request("authorization_code", { code: code })

• 确认Redirect URI一致性
  确保代码中REDIRECT_URI与TikTok开发者后台配置完全一致（包含协议、域名、路径，大小写敏感），即使Postman能成功，也需排除配置偏差。

• 手动编码参数验证
  可尝试手动将payload转为URL编码字符串，验证RestClient自动编码是否存在问题：

RestClient.post url, URI.encode_www_form(payload), headers

完成上述修改后，重新测试即可正常获取V2版本的访问令牌。

内容的提问来源于stack exchange，提问作者Donatien