图片转为文档
将图片转换为文档格式,当前支持的图片格式:png、 jpg、 jpeg、 bmp、 tif、 tiff、 gif。
注意
- 测试应用单次最多可转换3张图片。
- 单张图片支持的最大尺寸为50M。
目前支持转换为的文档类型:
| 文档类型 | 扩展名 |
|---|---|
| 文字 | docx |
| 表格 | xlsx |
| 演示 | pptx |
| JSON | json |
| 表格提取 | table |
请求说明
| 请求地址 | /v7/developer/weboffice/img/convert/to/:type |
|---|---|
| 请求方法 | POST |
| 权限要求 | 查询和管理格式转换 kso.format_conversion.readwrite |
Header 参数
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | 目前固定为: application/json |
| Authorization | 是 | string | 授权凭证,格式为:Bearer {access_token} |
Path 参数
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| office_type | 是 | string | 转换为的文件类型:docx,xlsx,pptx,json,table |
Body 参数
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| img_urls | 是 | array | 图片url集合 |
| text_unify | 否 | boolean | 统一段落字体字号,建议传true |
| sheet_option | 否 | integer | 转换为表格时配置:sheet转换方式 0表示每页pdf(每页图片)一个sheet, 1表示所有页面(图片)转到一个sheet中, 默认为0 |
| export_type | 否 | string | 表格提取时配置,输出类型:xlsx,html,默认为html |
返回参数
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| code | 是 | integer | 错误码 |
| data | 是 | data {} | 响应数据 |
| ├ task_id | 是 | string | 转换任务 id |
示例
请求示例
httpsnippet
{"method":"POST","url":"https://openapi.wps.cn/v7/developer/weboffice/img/convert/to/docx","headers":{"Content-Type":"application/json","Authorization":"Bearer ejxxx"},"data":{"img_urls": ["https://***.com/***"]}}
返回示例
json
{
"code": 0,
"data": {
"task_id": "0f27ff302780428e9ddfd39189731891"
}
}
查询异步任务结果
携带 task_id 查询结果
提示
task_id 有效期1个小时。超过一个小时,将自动删除本次转换结果缓存,请及时保存相关转换结果及文件。
错误码
请参考错误码说明