注册新主题

在线编辑

创建并注册您自己的主题以为租户定制应用程序。 配置应用程序时，选择用户创建的主题以显示包含定制内容的页面。 可以为每个应用程序使用不同的主题，也可以让多个应用程序使用相同主题。

准备工作

  1. 获取访问令牌。 请参阅 “管理主题 ”。
  2. 使用 API 下载主题。

关于此任务

下载现有主题并将其用作模板来创建新主题。 缺省主题可以在创建新主题时用作模板。 请保持相同的目录结构。

过程

  1. 从 “使用 API 下载主题 ”中解压压缩的主题文件，并修改这些文件，为您的 Verify 租户创建一个新的自定义主题。
    有关编辑主题文件的更多信息，请参阅：.
  2. 为您的自定义主题文件创建一个压缩主题文件，其目录结构应与步骤 1 中下载的文件保持一致。
  3. 要注册新主题，请将包含定制内容的压缩主题文件上载回租户。
    curl -X POST --header 'Content-Type: multipart/form-data' --header 'Accept: application/json' -F configuration=@<JSON configuration file> 'https://<tenant>/v1.0/branding/themes' -F 'files=@<update_theme_file>.zip' -H 'Authorization: Bearer <access_token>'
    其中：
    <JSON configuration file>
    主题注册配置有效内容，这是字符串编码的 JSON 对象。 示例：
    {
"name": "string",
"description": "string (optional)",
}
    <tenant>
    分配给您 Verify 订阅的完全合格域名。
    <update_theme_file>
    带有格式化主题结构的压缩主题文件的文件名。
    <access_token>
    您在 “管理主题 ”中收到的访问令牌的值。
    将向租户注册新主题。 将生成唯一的 themeId。
  4. 可选： 点击“关注 列出主题 ”，即可在您的租户中查看新注册的主题。 可以在 customized_only=true 的情况下下载主题，以验证定制文件的列表。 如需了解更多信息，请参阅 《使用 API 下载主题》。
  5. 要在应用程序中使用新主题，请在应用程序设置中将“主题 ”字段设置为新主题的名称。 如需了解更多信息，请参阅 “设置应用程序基本信息”。
    应用程序现在将使用所选主题。

示例

curl -X POST --header 'Content-Type: multipart/form-data' --header 'Accept: application/json' -F configuration=@config.json 'https://companyAppTest.verify.ibm.com/v1.0/branding/themes' -F 'files=@theme_file.zip' -H 'Authorization: Bearer JUHn05z35P4Kd9QaCLHFEyMGEbzeCOo0faBefI9w'