sign
使用三方纯签约的签约单号拉起用户签约页面。
支持版本
前端库版本不低于 0.0.28。
支持平台
支持场景
接入准备
前置条件
- Android:需用户已登录并完成抖音账号绑定,且当前处于前台可见页面
- iOS:需用户已登录并完成抖音账号绑定
使用说明
如果用户尚未绑定抖音账号,豆包可能先拉起账号绑定流程,再继续展示签约页面。
用户的最终签约状态必须以业务服务端查询签约单详情或收到的签约结果回调为准。 业务服务端还需要维护业务用户与签约 ID 的对应关系。
- 调用会拉起签约 UI 并需要用户交互,请在用户明确触发签约的交互场景中调用;请勿在无用户操作的后台逻辑中调用。
调用方式
异步 API
入参
调用示例
成功返回
返回示例
错误处理
错误对象和通用错误码见 通用错误处理。
失败示例
错误码
通用错误码
平台差异
- Android:需在前台可见的 Activity 中调用,应用退至后台或无有效页面时会返回失败。
- Android:用户主动取消签约时返回顶层 errNo 114(operation cancelled);iOS 在该场景不返回顶层专属 errNo。
已知限制与注意事项
- 失败结果不会作为 await 的返回值,需通过 catch 捕获并从错误对象的 data 字段读取 code、errNo、errMsg、errLogId。