Branch公开API生成的Web链接单次点击过期设置无效问题咨询

我来帮你排查这个一次性Branch链接的问题，之前处理过类似的场景，咱们一步步梳理可能的原因和解决办法：

• 确认API参数的正确层级
  很多人会犯的错误是把one_time_use放到了data对象里，但实际上这个参数是顶级请求参数，不是嵌套在data中的。正确的请求体结构应该是这样的（以JSON格式为例）：

  {
    "branch_key": "你的Branch密钥",
    "one_time_use": true,
    "data": {
      "$desktop_url": "https://你的目标Web链接",
      // 其他自定义参数（如果需要）
    }
  }
  

  另外，type参数其实在最新的Branch API里已经被one_time_use替代了，不需要额外设置type=1——直接设置one_time_use: true就足够标记为一次性链接。

• 检查Branch控制台的全局设置
  有时候控制台的全局配置会覆盖API传递的参数：

  1. 登录Branch控制台，进入Link Settings页面
  2. 查看是否有强制设置链接类型的选项，比如“默认链接类型”被设为永久，或者有禁用一次性链接的规则
  3. 确认没有开启“忽略API中的一次性链接设置”之类的全局开关

• 实际测试并验证链接属性
  创建链接后，不要只依赖控制台显示，要实际测试：

  1. 点击链接，确认正常跳转到$desktop_url
  2. 再次尝试访问同一个链接，看是否出现“链接已过期”或无法跳转的提示
  3. 使用Branch控制台的Link Inspector工具，输入生成的链接，查看one_time_use属性是否被正确标记为true——如果这里显示为false，说明参数传递肯定有问题

• 验证API请求的格式和端点
  确保你调用的是正确的Branch Public API端点：https://api.branch.io/v1/url，并且请求的Content-Type头设置为application/json。旧版本的API端点可能对one_time_use参数的支持不完善，建议使用最新的v1版本。

• 排除冲突参数
  如果你的请求中还设置了$exp_date（过期日期）参数，可能会和一次性链接的逻辑冲突——一次性链接的设计是点击即失效，不需要额外设置过期时间，建议暂时移除这个参数再测试。

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