回调网关

在集成 OfficeSDK 时，回调网关是接收来自 OfficeSDK 服务端的请求的关键。回调接口将通过该网关与您的服务进行通信。为了确保正常的回调交互，接入方需要配置并提供回调网关地址。

格式要求

为了确保回调请求能够成功发送并正确到达接入方的服务端，回调网关地址需要符合以下格式要求：

1. 协议要求
回调网关地址支持 HTTP 和 HTTPS 协议，可以根据需求选择适合的协议。

示例：

2. 地址类型
支持合法域名和本地地址。对于本地开发环境，可以使用 localhost 或 127.0.0.1，但生产环境建议使用 OfficeSDK 服务端可访问的域名地址。

示例：

3. 路径要求
回调网关路径应简洁，遵循 RESTful 风格，且仅包含字母、数字、短横线（-）、下划线（_）等合法字符。

示例：

4. 端口号支持
回调网关可以包含端口号，推荐使用标准端口（如 443 对 HTTPS，80 对 HTTP）。如果使用自定义端口，请确保该端口在防火墙中开放，且可供外部访问。

示例：

访问「回调配置」页面，配置回调网关地址。

⚠️ 注意事项：

谨慎修改：每次修改回调网关地址时，都会影响到所有与该地址相关的文件操作请求（如文件读取、保存等），请谨慎操作；

联调测试：在配置完回调网关后，务必进行联调测试。通过 OfficeSDK 控制台提供的测试功能模拟回调请求，确保回调网关地址能够正常接收和响应请求；

格式正确：如果回调网关地址格式不正确（如使用 HTTP 协议而非 HTTPS，域名或路径不合法，端口号不对等），OfficeSDK 服务将无法成功发送请求到该网关；

端口访问：使用自定义端口时，确保端口对外开放，且没有防火墙或网络配置的阻拦。如果端口不可用，OfficeSDK 将无法访问回调网关，导致请求失败；

可用性：确保回调网关地址的服务器在配置后可以保持高可用性。如果回调网关因网络问题、服务器故障等原因不可用，可能导致文件操作失败，影响用户体验。