onlyoffice 回调传参数_【onlyoffice中文指南】9-回调处理程序

ONLYOFFICE 文档编辑服务通过 POST 请求的 `callbackUrl` 通知文件存储服务文档状态。本文详细介绍了不同状态参数如 `actions`, `status`, `history` 等的含义及使用场景,并提供了 .Net, Java, Node.js, PHP 和 Ruby 的文档保存示例代码。" 104981069,8075565,Java程序性能优化技巧,"['Java', '性能优化', '集合框架', '字符串操作']
摘要由CSDN通过智能技术生成

作者

日期

雨中星辰

2018-12-20

该文档编辑服务通知文件存储服务有关使用文档编辑的状态callbackUrl从的JavaScript API。该文档编辑服务使用与身体信息的POST请求。

参数及其描述:

在版本4.2之前的ONLYOFFICE文档服务器中,使用了带有QueryString中的参数的GET请求。

参数

描述

类型

存在

actions

如果连接到文档的新用户共同编辑或与其断开连接,则定义收到的对象。在第一种情况下,类型字段值为1,在另一种情况下为0。的用户ID字段值是谁连接到或从共同编辑文件断开的用户的标识符。

对象数组

可选的

changeshistory

使用文档更改历史记录定义对象数组。

当状态值仅等于2或3时,该对象存在。必须被发送作为一个属性的变化发送作为参数传递给该对象的refreshHistory方法。

从版本4.2开始不推荐使用,请改用历史记录。

对象数组

可选的

changesurl

使用用于跟踪和显示文档更改历史记录的文档编辑数据定义文件的链接。

当状态值仅等于2或3时,链接存在。必须保存该文件,并且必须使用setHistoryData方法将其地址作为changesUrl参数发送,以显示与特定文档版本对应的更改。

string

可选的

forcesavetype

执行强制保存请求时定义启动器的类型。可以具有以下值:

* 0 - 对命令服务执行强制保存请求,

* 1 - 每次保存时执行强制保存请求(例如,单击“ 保存”按钮),仅当forceave选项设置为true时才可用。

* 2 - 使用服务器配置中的设置由计时器执行强制保存请求。

当状态值仅等于6或7时,存在类型。

整数

可选的

history

使用文档更改历史记录定义对象。当状态值仅等于2或3时,该对象存在。它包含对象serverVersion和变化,它们必须作为属性被发送serverVersion和变化发送作为参数传递给该对象的refreshHistory方法。

对象

可选的

key

定义编辑的文档标识符。

字符串

需要

status

定义文档的状态。可以具有以下值:

* 0 - 找不到带有密钥标识符的文档,

* 1 - 正在编辑文档,

* 2 - 文件已准备好保存,

* 3 - 发生了文档保存错误,

* 4 - 文件关闭,没有变化,

* 6 - 正在编辑文档,但保存当前文档状态,

* 7 - 强制保存文档时发生错误。

整数

需要

url

定义要与文档存储服务一起保存的已编辑文档的链接。

当状态值仅等于2或3时,链接存在。

字符串

可选的

userdata

定义发送到命令服务的自定义信息,以防它出现在请求中。

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
关于 onlyoffice 回调传参的问题,需要先了解 onlyoffice回调机制。在 onlyoffice 中,当用户在文档中进行编辑、保存等操作时,onlyoffice 会向指定的 URL 发送回调请求,以便通知该 URL 相关操作的结果和参数。 为了让回调 URL 接收到这些参数,需要在回调 URL 上定义相应的参数,只有定义了这些参数,才能在回调 URL 中获取相应的参数值。以下是一个示例回调 URL 的定义: ```php http://example.com/callback.php?status={status}&id={id}&version={version} ``` 在这个 URL 中,我们定义了三个参数:status、id 和 version。当 onlyoffice 发送回调请求时,会将相关参数的值替换到 URL 中,具体的参数值根据请求的操作类型而定。例如,当用户进行保存操作时,status 参数可能是 success,id 参数是文档的唯一标识符,version 参数是当前文档的版本号。 接下来,需要在回调 URL 对应的 PHP 文件中获取这些参数的值。以下是一个简单的示例: ```php $status = $_GET['status']; $id = $_GET['id']; $version = $_GET['version']; ``` 通过 $_GET['参数名'] 的方式,可以获取到相应参数的值,然后进行相应的处理。 注意,在实际开发中,需要对回调 URL 进行安全验证,以防止恶意请求。例如,可以在回调 URL 中加入一个随机字符串作为密钥,在 PHP 文件中进行验证,只有在验证通过时才能处理相应的参数值。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值