跳转到主要内容
1签 (OneSign)

企业签名常见问题

本页内容

按照出现问题的步骤排查:先确认认证和应用归属,再查看上传、开通、签名或下载结果。请求超时后优先查询原记录,避免重复上传、扣款或提交签名。

先定位失败步骤

  1. 确认失败来自平台 API,还是文件传输使用的存储地址。二者的请求方式和认证不同。
  2. 记录 HTTP 状态、error.code 和 request_id。
  3. 找到已保存的应用、上传、报价、订单或签名任务记录,按原操作查询结果。

上传成功、付款成功和签名成功分别确认,不能由一个步骤推断后续步骤也已完成。

认证与权限问题

现象检查与处理
401 InvalidCredentials检查网站主域名、AccessKey 对应关系、UTC 时间和请求签名。使用 SDK 时先运行身份查询。
403 AccessDenied检查本人账号功能、API 应用动作、资源范围、来源 IP、凭据有效期。长期 AccessKey 也只拥有已授予的权限。
应用不存在或列表为空检查 module=enterprise、完整应用 ID和账号归属。没有权限与记录不存在均可能返回 404。
429 Throttled按 Retry-After 有限等待;避免高频轮询。写入重试保留原幂等键。

上传问题

现象检查与处理
存储连接失败或上传中断保留原文件与任务 ID。检查网络、上传凭证有效期及存储要求,再查询已确认分片后继续。
进度 100%,却没有可用版本查询平台上传任务。只有 succeeded 且返回 version_id 才表示校验和保存成功。
工具拒绝恢复核对原 IPA 摘要、状态文件、网站、账号和 AccessKey ID。不要把另一份文件关联到旧任务。
取消返回 UploadConflict校验已开始或版本已保存时不能取消。继续查询原任务,不反复创建新的上传。

开通与付款问题

现象检查与处理
余额充足仍无法付款检查付款权限、精确来源 IP、账号与 API 应用预算,以及报价金额和修订号是否仍有效。
付款超时先查询原报价及回执,不能据此判定没有扣款。
开通密钥已使用核对原核销是否成功。已保存回执时直接查询;没有回执时使用原请求和原幂等键恢复,不能换键试用同一码。
看不到统计或无法退款分别核对统计授权和订单退款资格。statistics=null 不等于零安装,退款能力也不能从余额或套餐名称推断。

签名与下载问题

现象检查与处理
任务已受理但没有签名包查询任务最终状态,再查询 getJobResult。受理不是签名完成。
下载到另一轮签名的版本使用本次任务返回的 signed_version.id,不要取列表第一项。
not_recorded 或 removed旧任务缺少可靠关联或产物已清理。不能猜测一个最新版本代替原结果。
参数已保存,旧包没有变化参数用于后续签名,需要重新签名并下载新版本;旧包不会被远程改写。
下载凭证为空或过期按下载异常说明处理,确认需要后再明确申请新凭证。

提供排查信息

需要支持人员协助时,提供失败时间及其时区、接口名、HTTP 状态、错误码、request_id,以及相关应用或任务 ID。上传问题还可提供文件大小和失败阶段。

不要提供 AccessKey Secret、开通密钥、授权 URL 或原始设备导出内容。公共认证、幂等和错误处理另见接入排错与错误、幂等与重试。

继续阅读