纸飞机 API 对接有哪些常见错误及解决方法？

1. 查看是否开启API Token权限，进入开发者设置。

2. 回调URL需采用HTTPS协议，这个最容易被忽视。

3. 服务器防火墙拦截Telegram IP段，建议放开。

4. 消息处理函数必须返回200状态码，否则会被认为失败，进行重试。

5. 查看官方文档的更新日志，有时候接口规则会变。

6. 利用Webhook调试工具模拟发送消息来定位问题位置。

7. 记录日志，把接收到的原始数据打出来分析。

8. 时区设置错误导致定时任务异常，统一采用UTC时间。

9. 机器人账号需要先私聊激活才有效。

10. 大文件传输推荐CDN加速，防止超时断链。

常见错误有token错误，webhook地址未备案，消息处理超时等。

建议检查bot token 权限，确保服务器公网能访问，curl 检查webhook有效性。

收不到消息可能setWebhook失败，用getWebhookInfo检查。

消息体解析方法错误，要记得用json_decode方法解析。

验证服务器时间同步，时差会引起签名验证错误。

1. token权限问题，去botfather重新设置权限

2. webhooks配置异常，查看域名是否备案

3. api请求超时，增加try-catch重试

4. 消息体格式错误，用jsonlint校验结构

5. 跨域问题，后端增加CORS中间件

6. 服务器时间错误，同步NTP时间服务器

7. 日志不能开，打开DEBUG模式看错误信息

8. 代理ip被ban，换个干净的ip池试试

9. 消息id重复，使用redis保存已经发送的msg_id

10. 图片上传失败，检查文件类型是否在白名单中