PDF转换

适用版本>=v7.0.2502b.20250227
接口说明：PDF转换

请求说明

请求地址	配置域名+/openapi+`/v7/kdocs/pdf/convert`
请求方法	POST
签名方式	KSO-1（配置域名+/openapi不参与签名）
权限要求	应用文档PDF转换（应用授权） `kso.appfile.pdf_cps.readwrite`

Header	参数类型	是否必填	说明
Content-Type	string	是	使用：`application/json`
X-Kso-Date	string	是	RFC1123 格式的日期，例: `Wed, 23 Jan 2013 06:43:08 GMT`
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》
Authorization	string	是	授权凭证，格式为：`Bearer {access_token}`

请求体（Body）

名称	类型	是否必填	说明
drive_id	string	是	驱动盘id，长度不超过1024位
file_id	string	是	文件id
format	string	是	转换后文件格式，目前仅支持`pdf`
dst_drive_id	string	否	指定结果文件存储的drive盘，不传时默认与原文档存同一个盘内
file_name	string	否	另存后新文件的名称，不填则使用源文件名称
from_page	integer	否	转换起始页 eg: 起始页和结束页设置[1, 3] 转换1~3页，都为0转换整个文档
to_page	integer	否	转换结束页
user_id	string	否	用户id

请求体示例

json

{
  "drive_id": "string",
  "dst_drive_id": "string",
  "file_id": "string",
  "file_name": "string",
  "format": "pdf",
  "from_page": 0,
  "to_page": 0,
  "user_id": "string"
}

响应体（Response）

名称	类型	说明
data	object
∟ task_id	object	异步任务ID
code	int	错误码
msg	string	状态信息
detail	string	详细信息

响应体示例

json

{
  "data": {
    "task_id": "string"
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}