如何通过群晖Surveillance Station Web API获取快照并用于网页？

Hey Eric, 作为刚接触Synology Surveillance Station Web API的新手，遇到这种情况太正常了——我当年第一次折腾的时候也踩过类似的坑！咱们一步步捋，先确认你对API的核心理解有没有偏差，再排查可能的问题点：

你可能误以为直接调用某个接口就能拿到JPG二进制，但实际上这个API的快照接口依赖前置认证，且参数要求很严格，一旦出错返回的就不是图片，而是JSON错误信息或者其他提示内容。

最可能的几个理解偏差&问题点 #

1. 跳过了关键的认证步骤 #

所有Surveillance Station的API请求都需要先通过SYNO.API.Auth接口获取会话凭证（sid），否则服务器会直接返回权限不足的JSON，而不是图片。

举个完整的认证流程示例：

1. 先调用登录接口获取会话ID：

   http://你的群晖IP:端口/webapi/auth.cgi?api=SYNO.API.Auth&version=3&method=login&account=你的账号&passwd=你的密码&session=SurveillanceStation&format=sid
   

   成功的话会返回类似{"data":{"sid":"xxxxxx"},"success":true}的JSON，把里面的sid记下来。
2. 后续所有快照请求都必须带上_sid=xxxxxx参数，否则会被拒绝。

2. 快照接口的参数配置错误 #

常用的快照接口是SYNO.SurveillanceStation.Camera下的GetSnapshot方法，正确的请求格式应该是这样：

http://你的群晖IP:端口/webapi/entry.cgi?api=SYNO.SurveillanceStation.Camera&version=9&method=GetSnapshot&cameraId=1&_sid=你的会话ID

这里要注意几个细节：

• cameraId必须是你系统中实际存在的摄像头ID（可以通过SYNO.SurveillanceStation.Camera.List接口获取所有摄像头的ID列表）
• version参数要和你的Surveillance Station版本匹配（比如v9对应较新的DSM7.x版本，老版本可能需要用v7或v8）
• 如果cameraId填错或者没有权限访问该摄像头，返回的会是JSON错误，而不是JPG。

3. 浏览器对返回内容的解析问题 #

如果你的请求其实是正确的，但浏览器显示的是乱码或者奇怪的文本，那可能是浏览器把二进制图片流当成了文本解析。这种情况下，你可以直接把请求地址放到网页的<img>标签里试试：

<img src="http://你的群晖IP:端口/webapi/entry.cgi?api=SYNO.SurveillanceStation.Camera&version=9&method=GetSnapshot&cameraId=1&_sid=你的会话ID" alt="摄像头实时快照">

浏览器会自动识别二进制流并渲染成图片。

快速排查方法 #

右键浏览器返回的“其他内容”页面，选择「查看页面源代码」，看看是不是JSON格式的错误信息：

• 如果是{"error":{"code":105}}：代表认证失败，检查会话ID是否正确或者有没有携带_sid参数
• 如果是{"error":{"code":106}}：代表摄像头ID错误或者没有访问权限
• 如果是乱码：尝试用<img>标签加载这个地址

内容的提问来源于stack exchange，提问作者Eric