lark-slides xml_presentations get
用途
读取飞书幻灯片（PPT）演示文稿的完整 XML 内容信息。
命令
lark-cli slides xml_presentations get --as user --params '<json_params>'
参数说明
| 参数 |
类型 |
必需 |
说明 |
--params |
JSON string |
是 |
路径参数与查询参数，结构以 schema 为准 |
params JSON 结构
{
"xml_presentation_id": "slides_example_presentation_id",
"revision_id": -1
}
| 字段 |
类型 |
必需 |
说明 |
xml_presentation_id |
string |
是 |
演示文稿的唯一标识符 |
revision_id |
integer |
否 |
版本号，-1 表示最新版本 |
使用示例
基础示例
lark-cli slides xml_presentations get --as user --params '{"xml_presentation_id":"slides_example_presentation_id"}'
结合 jq 格式化输出
lark-cli slides xml_presentations get --as user --params '{"xml_presentation_id":"slides_example_presentation_id"}' | jq -r '.data.xml_presentation.content'
保存到文件
lark-cli slides xml_presentations get --as user --params '{"xml_presentation_id":"slides_example_presentation_id"}' > presentation_data.json
返回值
成功时返回演示文稿的完整信息：
{
"code": 0,
"data": {
"xml_presentation": {
"presentation_id": "slides_example_presentation_id",
"revision_id": 1,
"content": "<presentation xmlns=\"http://www.larkoffice.com/sml/2.0\" height=\"540\" width=\"960\">...</presentation>"
}
},
"msg": "success"
}
返回字段说明
| 字段 |
类型 |
说明 |
data.xml_presentation.presentation_id |
string |
演示文稿唯一标识 |
data.xml_presentation.revision_id |
integer |
版本号 |
data.xml_presentation.content |
string |
XML 格式的完整内容 |
常见错误
| 错误码 |
含义 |
解决方案 |
| 404 |
演示文稿不存在 |
检查 xml_presentation_id 是否正确 |
| 403 |
权限不足 |
检查是否拥有 slides:presentation:read scope，或是否有访问权限 |
| 400 |
参数格式错误 |
确保 --params 是合法的 JSON 字符串 |
注意事项
- 执行前必做: 使用
lark-cli schema slides.xml_presentations.get 查看最新的参数结构
- 返回的 XML 在
data.xml_presentation.content 字段中
- 如果只需要部分信息，可以使用
jq 等工具过滤返回结果
- 建议将获取的 XML 保存为文件，便于后续编辑或备份
相关命令
