错误处理
调用Reactor API时出现问题时，可能会通过以下方式之一返回错误：
- 立即错误：执行导致立即错误的请求时，API会返回错误响应，HTTP状态反映所发生的一般错误类型。
- 延迟错误：执行导致延迟错误的API请求（如异步活动）时，相关资源的
meta.status_details中的API可能会返回错误。
错误格式
错误响应旨在符合JSON：API错误规范，并且通常遵循以下结构：
{
"errors": [
{
"id": "8a5526da-ab12-4be9-b084-2efe537f388c",
"status": "404",
"code": "not-found",
"title": "Record Not Found",
"meta": {
"request_id": "jfb0dQ2e0XVTkQ6AOfEJFfTDjguw9x3d"
},
"source": {
"pointer": "/data"
}
}
]
}
属性
描述
id此特定问题发生的唯一标识符。
status适用于此问题的HTTP状态代码，以字符串值表示。
code应用程序特定的错误代码，以字符串值表示。
title不应将 从发生次数更改为发生次数的简短易于用户阅读的问题摘要，用于本地化目的除外。
detail特定于此问题的可读说明。 与
title一样，此字段的值也可以本地化。source一个对象，其中包含对错误源的引用，可以选择包含以下任意成员：
pointer： JSON指针(RFC6901)字符串，它引用请求文档中的关联实体（例如，主数据对象的/data或特定属性的/data/attributes/title）。
meta包含有关错误的非标准元数据的对象。
错误引用
下表列出了API可以返回的不同错误。
错误标题
描述
authentication-failure您的IMS访问令牌无效。 您可以通过再次登录来获取新的访问令牌。 或者，对于技术帐户，生成新的JWT并替换IMS访问令牌。
connection-refused无法建立到服务器的连接。
decrypt-bad-passphrase无法使用提供的密码解密数据。
decrypt-failed无法使用提供的私钥解密数据。 确保密钥在本地生效并且已修剪空白。
decrypt-no-data如果没有私钥，则无法解密数据。 请提供加密的私钥。
delegate-descriptor-unresolved扩展未提供此委托描述符的预期定义。 可能需要更新扩展。
deleted-resources您尝试添加到库的资源已被删除。
environment-in-use一个环境一次只能分配给一个库。 选项1是选择其他环境。 选项2是通过将库移动到其他环境或删除库来释放此环境。
environment-required在创建内部版本之前，必须为库分配一个环境。
extension-not-found定义数据元素或规则组件的扩展不包含在库中。 请确保已将所有必需的扩展添加到库中。
extension-package-path-errorextension.json中定义的路径构造不正确。
extension-package-transform-definition-error您为对象属性定义了无效的转换。 每个对象属性都可以定义一个转换，并且它必须是文件转换或函数转换。
extension-package-zip-error解压缩ExtensionPackage或压缩文件进行分发时出错。
host-in-use如果一个或多个环境正在使用某个主机，则无法删除该主机。
host-required分配给此库的环境没有有效的主机。 检查为库分配的环境。 然后，将有效的主机分配给该环境。
host-type-error只有SFTP主机需要先验证凭据才能使用，因此预测试仅适用于该主机类型。
illegal-custom-code-transform不允许使用customCode转换。 请指定函数或文件转换。
ims-not-authorized授权帐户时出现未知错误。 请稍后重试。
ims-session-error登录会话有问题。 请注销并重新登录。
internal-error发生内部错误。 请等待几分钟，然后重试。 如果问题仍然存在，请联系客户关怀团队。
invalid-data_element无法将无效的数据元素添加到库中。
invalid-embed_code这不是有效的嵌入代码，或者您尝试将其链接到开发或暂存环境。 动态Tag Management (DTM)嵌入代码只能链接到生产环境。
invalid-extension无法将无效的扩展添加到库中。
invalid-extension_package_id您只能修改扩展包的某些对象属性。 您试图修改其中一个不允许的项。
invalid-new-owner-org-id您尝试分配的组织ID不是有效的组织ID。
invalid-org您的活动组织无权访问API。 检查您使用的组织是否正确。
invalid-rule无法将无效的规则添加到库。
invalid-settings-syntax分析设置JSON时遇到语法错误。
library-file-not-found在zip包中找不到extension.json中定义的所需文件。
minification-error由于代码无效，无法编译代码。
multiple-revisions库中只能包含每个资源的一个修订版。
no-available-orgs此用户帐户不属于有权访问标记的产品配置文件。 使用Admin Console将此用户添加到具有标记权限的产品配置文件中。
not-authorized此用户帐户没有执行此操作所需的权限。
not-found找不到该记录。 验证您尝试检索的对象的ID。
not-unique您尝试使用的名称已在使用中。 对于此资源，“name”属性必须是唯一的。
public-release-not-authorized扩展的公开发布由
launch-ext-dev@adobe.com协调。 有关详细信息，请参阅有关发布扩展的文档。read-only此资源是只读的，无法修改。
session-timeout用户会话已过期。 请注销并重新登录。
sftp-authentication-failedSFTP连接的身份验证失败。
sftp-connection-timeoutSFTP连接已超时。
sftp-exception使用SFTP连接到服务器时遇到异常。
sftp-status-exception尝试与服务器通信时遇到SFTP异常。
socket-error尝试与服务器通信时遇到套接字错误。
ssh-disconnectSSH会话已断开连接。
timeout-error与服务器的连接超时。
unknown-error发生意外错误。 您可以稍后再试，或致电客户关怀部门，并解释事件发生时您正在做什么。
unsupported-custom-code-language提供的自定义代码语言不受支持。
upgraded-extension-required安装扩展升级后，必须将其包含在所有库中，直到升级进入生产环境。 唯一的例外是尚未发布扩展。
upstream-build-required您需要先成功生成上游库，然后才能生成此库。
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743