缩略图

获取储存于印象笔记中的图像数据的缩略图


印象笔记服务可以产生笔记或单个资源的缩略图。缩略图的格式可以是 PNG,JPEG,或 GIF (在响应的头部 "Content-Type" 中定义),并且不需要你剪裁就可以放在 300x300 像素的方形区域中。图像的一个或两个维度可能会小于这个区域的大小,所以图像应当在一个恰当的背景和/或相框中居中。例如,如果你请求一个 64x64 原始大小的图像的缩略图,服务会直接返回给你原图。

缩略图不是通过云 API 来访问的。相反,你可以直接发送给印象笔记服务一个 HTTP POST 请求来得到它。要取得一条笔记的缩略图,可以使用下面的 URL:

https://host.evernote.com/shard/shardId/thm/note/GUID

这里的 host 是印象笔记服务的主机名,比如 sandbox.yinxiang.com, shardId 是认证时取得的 shardId,而 GUID 就是笔记的 GUID。

要取得一个资源的缩略图,使用如下 URL:

https://host.evernote.com/shard/shardId/thm/res/GUID

这里的 GUID 就是资源的 GUID。

可选参数

你可以通过在 GUID 后面添加 .jpg.gif.bmp.png 后缀来指定返回的缩略图格式。

你可以通过传递一个名为 size 的 POST 参数来得到一个更小的缩略图。这个参数的范围是 1 到 299,它指定了期望的方形区域的以像素为单位的大小。服务器会返回一个适合这个方形容器的图像,但是图像的一个或两个维度可能会小于这个指定的值。如果图像的大小是 300 的偶数倍数(例如 150 或 75),那么图像会看起来更好。

示例

下面的例子访问了一个用户在 sandbox.yinxiang.com 服务的 shard s1 上的缩略图。注意,因为这些笔记在一个公共笔记本中,所以我们不需要认证。并且为了简化例子,我们使用了 GET 而不是 POST。

得到 GUID 为 e669c090-d8b2-4324-9eae-56bd31c64af7 的笔记的完整缩略图:
https://sandbox.yinxiang.com/shard/s1/thm/note/e669c090-d8b2-4324-9eae-56bd31c64af7

得到同样笔记的 75x75 大小的 JPEG 格式的缩略图:
https://sandbox.yinxiang.com/shard/s1/thm/note/e669c090-d8b2-4324-9eae-56bd31c64af7.jpg?size=75

得到一个 GUID 为 8528dddd-1d71-4e4d-9006-377be7517dfb 的图像资源的完整缩略图:
https://sandbox.yinxiang.com/shard/s1/thm/res/8528dddd-1d71-4e4d-9006-377be7517dfb

真实情况下,认证的 POST 请求就像这样:

要注意其中的 POST 参数 auth;如果请求的笔记或资源不在公共笔记本中的话,那么就必须包含有效的认证 token(这里开发者 token 也行)。另外,对于公开笔记本中的笔记或资源,这个 auth 参数就不是必需的而且应该会被忽略掉。