自建插件FAQ

1. 插件代码如何在本地进行调试开发?

由于插件代码本身只是方法体， 所以需要在外层进行代码包裹后， 再进行调用调试。

本地调试通过后，可将插件部分代码拷贝到简道云里面，点击插件调试进行实际运行环境下的调试。

2. 插件适用的场景?

插件通过定义输入输出的格式，实现一些定制化的业务需求。

但是并不适合常驻类型的操作，目前插件本身的超时时间为 60 s。

3. 如何处理各集成平台的Access Token?

简道云目前已实现了插件 Access Token 内置企业微信、钉钉、飞书的自建应用以及微信公众号，也支持开发者自定义 token 的获取方式，同时不需要关心 token 的缓存更新等问题，可以直接使用。

4. 目前插件支持base64库吗？

base64 为 python 内置库，可直接调用。

5. 为什么返回的图片地址无法访问？

简道云目前的链接是有有效期限的，如果返回后过了有效期再处理，则会显示错误。

6. 关于时间，同样的代码在本地和在插件中获取的时间怎么不一致？

插件所在服务器为 UTC 时区，本地代码依据开发者本地服务器所在时区而定。由于服务器所在时区差异，可能会出现同样的代码在本地和插件中执行所得到的实际时间不同。

7. 为什么返回的图片不能直接回写到图片字段中？

目前插件在前端事件触发场景中，暂不支持将图片直接回写至图片字段，只能通过返回图片 url 至文本字段来实现。

出于风险因素考虑，短期内暂无计划支持回写图片/附件字段。

8. 为什么插件的可选通用参数不配置或配置后清空，插件会报错？

通用参数不配置时，初始值为 Null 不为空，需定义通用参数不填时默认空值。

9. 插件的IP是不固定的吗？

插件市场中安装的插件 IP 地址固定，但自建插件中则不固定且完全随机，客户可以通过自有服务器转发插件请求来实现固定 IP。

10. 插件无法定时重复触发吗？

目前自建插件支持定时触发，但最小颗粒度为 1 天触发一次。

如果希望能够实时或更小颗粒度的定时自动触发，目前暂不支持。

11. 部分接口无法接收url格式的图片，如何处理？

可以先下载图片，将图片 URL 解析为 base64 格式的字符串后发送。

更多常见问题答案，持续更新中... ...