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

创建与管理企业签名应用

本页内容

企业签名应用是安装包、签名任务、服务权益和统计数据的归属对象。首次上传需要先创建应用;更新同一个应用时继续使用原应用 ID。

选择创建或更新

要完成的任务处理方式
平台上尚无这个应用创建预留记录,保存应用 ID,在有效期内上传首个 IPA。
给已有应用上传新版本查出原应用 ID,直接创建上传任务;无需重新创建应用。
名称或备注需要调整先读取应用资料和修订号,再保存修改。

前提条件

完成SDK 初始化。为 API 应用授予所需动作和自有应用范围;创建新应用还需要创建与上传权限,且授权范围包含未来应用。企业签名使用 module=enterprise 和 platform=ipa。

创建新应用

  1. 从真实 IPA 取得名称和 Bundle ID,为本次创建生成并保存幂等键。
  2. 调用 预留新应用,保存返回的 id 和 expires_at。
  3. 在预留期限内创建上传任务,传输并校验 IPA。此时创建预留记录只是第一步,还没有可用安装包。
Python SDK
def create_application(client, name, bundle_id, create_key):
    # create_key 已在首次请求前保存;恢复本次创建时传入原值。
    return client.create_app(
        "enterprise", "ipa", name, bundle_id, create_key
    )["data"]

示例函数接收已经保存的 create_key,不要在每次网络重试时重新生成。响应丢失且没有应用 ID 时,用原请求和原幂等键重试;已保存应用 ID 时可调用 查询应用创建进度确认预留状态。过期后先核对应用列表,再决定是否重新创建。

查询已有应用

按名称、Bundle ID 或备注关键词查询企业签名应用。首次查询省略游标;继续翻页时使用返回的 next_cursor,并保持其他筛选条件不变。

Python SDK
def find_applications(client, keyword, cursor=None):
    return client.list_apps(
        module="enterprise", search=keyword, limit=50, cursor=cursor
    )["data"]

精确包名查询可使用 bundle_id 参数,详细字段见 列出已授权应用。取得应用 ID 后,用 查询应用详情核对所属产品、平台和包名。不同账号或未获授权的应用不会出现在可访问范围中。

修改名称和备注

先读取最新资料,再将 revision 带回。清空备注时传空字符串。修改展示资料不会改变 IPA 内的实际 Bundle ID。

Python SDK
def update_application(client, app_id, name, remark, write_key):
    current = client.get_app_metadata(app_id)["data"]
    return client.update_app_metadata(
        app_id, current["revision"], name, remark, write_key
    )["data"]

如果返回 RevisionConflict,说明内容已经变化。重新读取并核对差异,确认后再提交新的修改。

删除应用

  1. 读取并展示应用名称、Bundle ID 和应用 ID,让使用者确认目标。
  2. 取得明确确认后,保存本次删除的幂等键,调用 确认删除应用。HTTP 请求中的 confirm_app_id 必须与目标应用一致,SDK 会填写该字段。
  3. 检查返回的 state 和 files_retained。删除后不再提供该应用原有服务。
应用删除、文件保留与订单退款是不同操作。删除应用不会自动退款,文件按平台保留规则处理。

相关接口