1.3. 修改原生开发者门户的其他 3scale 功能描述

3scale 提供了许多用于自定义原生开发人员门户的功能,以创建自己的开发人员门户。

在开发开发人员门户期间,需要查看开发人员门户的任何人都必须指定访问代码。在 API 供应商执行必要的任务来打开您的开发者门户时,请保留此访问代码,但 API 用户访问代码可确保只有具有此代码的任何人都可以查看您的开发人员门户。访问代码位于 Domains & Access 页面中,该页面中可通过选择 Audience> Developer Portal > Domains & Access 来获得。

以下列表引入了一些修改原生开发人员门户的功能:

  • Developer Portal > Content 环境中,右上角的 New Page 下拉菜单可让您在 Developer Portal 中添加以下元素:

    • Page - 开发者门户内容的基本单元。
    • Layout - 多个页面可使用的模板。
    • Partial - 可在其他部分、布局和页面中重复使用的内容。
    • Section - 功能相当于一个目录。创建部分以组织开发人员门户内容。
    • File - 您希望开发人员门户使用的资源,如样式表、镜像或脚本。
    • Portlet - 外部 RSS 源、内容表或最新论坛文章。
  • 您可以在 HTML、Markdown 或 Textile 中输入代码。代码编辑器支持代码突出显示、表格化、行号和其他功能。
  • 您可以预览页面的草稿版本或发布版本。在页面的文本编辑器中,单击 Preview 会显示开发人员门户的开发版本。

    preview 右侧有一个暗灰色的垂直拦。在黑色星形图的顶部,突出显示 Draft | Published 之一来指示您要查看的版本。这个栏包含到编辑环境的链接:

    • 该页面。
    • 页面使用的布局。
    • 页面使用的任何部分。部分代码是在不同页面上的多个位置重复使用的代码。

    开发人员门户的开发版本的 Draft 视图支持迭代/递增改进。当 Draft 版本外观和行为时,您可以发布它。当访问代码就位时,发布页面意味着您可以查看 API 用户是否活跃。当访问代码不再就位时,在 live Developer Portal 中发布该页面。

  • filter 字段允许您在 Developer Portal 环境中搜索资源。3scale 仅显示您要搜索的元素,这样可以更轻松地查找您想要进行的操作。过滤器字段在图标下方:

    Developer Portal 过滤器字段
  • Developer Portal > Redirects 页面可让您将重定向从一个开发者门户 URL 设置为另一个。例如,如果您弃用了您创建的页面,您可以将请求重定向到新页面。
  • 占位符是可编辑的字段。例如,Developer Portal > Content > Login > New 页面有几个占位符:

    <input id="session_username" name="username" tabindex="1"
      autofocus="autofocus" type="text"
      placeholder="Authenticate with your email"
      class="form-control">
    ...
    <input id="session_password" name="password" tabindex="2"
      type="password"
      placeholder="…and password"
      class="form-control">

    此代码在 Developer Portal 中生成以下字段:

    Developer Portal 占位符字段

    您可以更新占位符文本,并发布它以在开发人员门户中看到更新。例如,您可以将 带有您的电子邮件的 Authenticate 更改为 Authenticate email。发布页面后,您可以在 Developer Portal 中看到更新的提示,例如:

    Developer Portal 更新了占位符字段