当 Tiny Cloud 检测到问题时,它会显示一个包含问题信息的编辑器通知。本文档介绍了常见 Tiny Cloud 错误通知的原因和解决方案。

此处显示的通知措辞可能与 Tiny Cloud 实际显示的通知有所不同。

无效的 API 密钥

"继续使用 TinyMCE 需要有效的 API 密钥。请通知管理员检查当前的 API 密钥。点击此处了解更多。"

原因

出现此通知的情况如下:

  • 脚本标签中未提供 apiKey,

  • 提供了空的或丢失的 apiKey,或

  • Tiny Cloud 服务器上找不到提供的 apiKey。

apiKey 必须满足:

  • 长度精确匹配,

  • 由特定字符组成,并且

  • 使用 Tiny Account 页面 上的 Tiny Cloud 账户创建。

例如:

<script src="https://cdn.tiny.cloud/1/abcd1234/tinymce/8/tinymce.min.js" referrerpolicy="origin" crossorigin="anonymous"></script>

在这种情况下,编辑器将处于只读状态,并显示一条通知:"继续使用 TinyMCE 需要有效的 API 密钥。请通知管理员检查当前的 API 密钥。点击此处了解更多。”

解决方案

要解决此问题:

  1. 更新 src URL 以包含您的(网站或应用程序开发人员的)Tiny Cloud API 密钥,通过将占位符 no-api-key 替换为实际的 API 密钥。

    例如:如果您的 API 是 abcd1234:

    <script src="https://cdn.tiny.cloud/1/abcd1234/tinymce/8/tinymce.min.js" referrerpolicy="origin" crossorigin="anonymous"></script>
  2. 检查脚本标签中提供的 apiKey:

    • 删除任何前导或尾随空格。

    • 删除 apiKey 中不存在的任何其他字符。如果您使用变量替换,请确保变量正确替换。

    • 确保 apiKey+ 与 https://www.tiny.cloud/my-account 上显示的 API 密钥匹配。

  3. 如果您没有 API 密钥,或者需要检索现有密钥,请访问:Tiny Cloud。

访问我们的 无效 API 密钥 页面,了解有关如何解决 TinyMCE 无效 API 密钥 问题的更多信息。

无 API 密钥

"继续使用 TinyMCE 需要有效的 API 密钥。”(控制台消息)

原因

当 apiKey 设置为 no-api-key 时,编辑器将处于只读状态,用户将看到一个"完成设置"对话框,提示他们添加有效的 API 密钥、配置域名并探索高级功能。

onboarding finish setting up dialog

解决方案

  1. 更新 src URL 以包含您的(网站或应用程序开发人员的)Tiny Cloud API 密钥,通过将占位符 no-api-key 替换为实际的 API 密钥。

例如:如果您的 API 是 abcd1234:

<script src="https://cdn.tiny.cloud/1/abcd1234/tinymce/8/tinymce.min.js" referrerpolicy="origin" crossorigin="anonymous"></script>

要检索 API 密钥或注册 API 密钥,请访问:Tiny Cloud。


域名未注册

"该域名未在 TinyMCE 客户门户中注册。请通知管理员将其添加到已批准的域列表中,以便继续使用 TinyMCE。点击此处了解更多。"

原因

当页面的 Referer 与您 apiKey 下存储的已批准域名列表不匹配时,会显示此通知。Tiny Cloud 通过检查网络请求中的 Referer 头部的域名部分来验证 TinyMCE 加载的域名。您可以在 Tiny Account 上查看已批准域名的列表。

有时 Referer 头部中的域名与浏览器地址栏中的 URL 不匹配。要检查 Referer 头部:

  • 打开浏览器的 开发者工具。

  • 打开 网络 选项卡。

  • 查找并选择使用您的 API 密钥从 Tiny Cloud 加载 TinyMCE 的请求。

  • 单击 标头 选项卡。

在名为请求标头的部分中,应该有一个 Referer 字段。这是 TinyMCE 用来与您的已批准域名进行比对的数值。它必须与您 Tiny Account 上列出的已批准域名之一匹配。

解决方案

如果 Referer 对于该站点是正确的,请确保该域名包含在 Tiny Account 上的已批准域名列表中。如果 Referer 不是您预期的,您可能需要调整应用程序的 Referer 头部 设置。


缺少 Referer 头部

"我们无法检查您的域名,因为缺少 referer 头部。请阅读指南以确保您的 referer 头部存在,然后我们可以为您定制编辑器体验。"

原因

  • 如果在从 Tiny Cloud 加载 TinyMCE 的网络请求中缺少 Referer 头部,则会显示此通知。Tiny Cloud 通过检查网络请求中 Referer 头部的域名来验证 TinyMCE 加载的域名。

  • Referer 头部有时会因浏览器设置或浏览器扩展而被移除。Tiny Cloud 只需要 Referer 头部中的域名,因此为了提高性能和隐私性,Tiny 建议在请求 Tiny Cloud 资源时将 referrerpolicy 设置为 origin。

解决方案

确定是哪个浏览器设置或扩展负责阻止发送Referer。常见的扩展是 Referer Control:

一旦确定了设置或扩展,请修改它以允许仅发送 Referer 的 Origin。或者,禁用使用 Tiny Cloud 的任何页面的扩展或设置。


高级插件故障排除

"_ 高级插件未在您的 API 密钥上启用。升级您的账户。”

原因

当您的 API 密钥无法访问所请求的高级插件时,会显示此通知。这可能是由于试用版过期,而您的 TinyMCE 配置试图加载您不再可以访问的高级插件。

如果您使用了错误的 API 密钥,也可能看到此通知。请确保您使用的是具有正确权限的 API 密钥。

解决方案

要么从 TinyMCE 配置中删除高级插件,要么升级您的订阅以获得对该高级插件的访问权限。

访问我们的 无效 API 密钥 页面,了解有关如何使用 TinyMCE 修复 无效 API 密钥 的更多信息。

只读模式 - 无 API 密钥

"TinyMCE 处于只读模式。请通知管理员继续使用需要 API 密钥。了解更多

原因 "无 API 密钥(只读模式)"

当开发人员未提供 API 密钥时会发送此消息,通常是因为他们复制了入门脚本但未完成官方的 注册 流程以获取 API 密钥。

解决方案

访问我们的 无效 API 密钥 页面,了解有关如何使用 TinyMCE 修复 无效 API 密钥 的更多信息。

只读模式 - 无效的 API 密钥

“TinyMCE 处于只读模式。请通知管理员提供有效的 API 密钥以继续使用。了解更多 您的 TinyMCE 编辑器状态已设置为只读模式。”

原因“无效的 API 密钥(只读模式)”

当 API 密钥不正确时(例如由于拼写错误),将显示此消息。

解决方案

  • 登录您的 TinyMCE 账户,并通过访问 www.tiny.cloud/auth/login/ 确认您的 API 密钥是否与您的唯一密钥匹配。

  • 或者,若要注册 API 密钥,请访问:Tiny Cloud。

只读模式 - 无效来源

“TinyMCE 处于只读模式。请要求管理员将此域名添加到客户门户中的已批准域名列表。更多信息请参阅“域名未注册””

原因“无效来源(只读模式)”

当 TinyMCE 从尚未添加到我们账户门户中已批准域名的域名加载时,将显示此消息。

解决方案

请要求您的管理员将此域名添加到客户门户中的已批准域名列表。更多信息请参阅“域名未注册”

从 TinyMCE 7.6.0 开始,编辑器使用禁用模式而不是只读模式。