错误码14000

错误截图

错误描述

无效的请求参数：请求参数缺失、格式错误或校验失败。

解决方案

常见场景

错误信息	说明
token is required	请求体中缺少 token 字段
params is required	请求体中缺少 params 字段
params is not a valid JSON string	params 不是合法的 JSON 字符串
One of token/repoId/meta/downloadUrl is null	params 中缺少必要字段
The params decoded from the token is incomplete	JWT 解码后的 payload 不完整
downloadUrl not match mediaUrl	downloadUrl 的 host 与三方应用接口地址不一致
uploadUrl not match mediaUrl	uploadUrl 的 host 与三方应用接口地址不一致
mentionUrl not match mediaUrl	mentionUrl 的 host 与三方应用接口地址不一致
notifyUrl not match mediaUrl	notifyUrl 的 host 与三方应用接口地址不一致

缺少 token 或 params

前端 SDK 集成模式下，JSSDK 初始化时会向文档中台发送 POST 请求，请求体结构如下：

{
  "token": "JWT 签名字符串",
  "params": "初始化配置对象的 JSON 字符串"
}

请确认 token 和 params 均已正确传递。params 应为完整的初始化配置对象序列化后的 JSON 字符串，配置字段说明参考 配置。

params 不是合法的 JSON 字符串

检查 params 的值是否为有效的 JSON 字符串。常见错误包括：使用了 JavaScript 对象而非 JSON 字符串（应使用 JSON.stringify() 序列化）；JSON 字符串中包含未转义的特殊字符；字符串拼接时遗漏引号或括号。

必要参数缺失

params 中必须包含 meta（至少含 id、name、modified_at、permissions）、userinfo（至少含 id）、repoConfig.downloadUrl。同时 JWT token 的 payload 中也需包含完整信息：meta.id、meta.permissions.read 和 meta.permissions.write（布尔值）、userinfo.id、repoConfig.id、openConfig.action（值为 edit 或 view）。完整说明参考 配置 和 签名。

URL host 不匹配

repoConfig 中的 downloadUrl、uploadUrl、notifyUrl、mentionUrl（如有）的 host 必须与管理控制台中配置的三方应用接口地址 host 一致（含 hostname 和端口）。例如，三方应用接口地址为 https://demohost:8080/v2/context，则 downloadUrl 应为 https://demohost:8080/v2/context/{docId}/content 格式。如果 URL 中 host 不带端口，相关配置也不要带端口；协议（http/https）不同时，host 比较仍基于 hostname 和端口。管理控制台配置参考 前期准备。