{} Make Use More Simple.

Peek Website Thumbnail And Use It

截取网站缩略图并应用在你的网站上

因为服务器原因,此接口已停止开放,敬请期待开源

写这个项目是受到一个朋友@难得有心人的启发, 因为目前国内似乎是没有做这类项目的,而且国外的服务又太慢,于是决心自己做一个这样的项目并开放使用。

有时候想想如果能把朋友或客户的网站截取第一屏放在自己的友链上或者客户展示的位置也是个不错的想法~ 一个个去截图自然有些麻烦,尤其是针对目录类的网站使用手动的方式就更不靠谱了。

使用本接口可以非常方便的完成截图工作并显示为图片。

优点/缺点

优点:

  • 调用方便,直接URL参数调用
  • 支持多种尺寸的缩略图
  • 支持以HTTPS方式调用本接口,应用在HTTPS网站不会有障碍
  • 使用国内云主机,10MB独享带宽,生成速度快

缺点:

  • 因获取网站截图逻辑比较复杂,也相当消耗服务器资源,所以第一次获取截图会很慢(一般大于5秒)
  • 还是因为获取截图太占用服务器资源,所以不得不采用任务队列的方式来依次获取,以防止过多的请求导致服务器崩溃
  • 无法获取墙外的网站截图,原因你懂得~~
  • 只支持获取网站首页的截图,暂未支持内页

本接口目前处于测试版本,仍有很多需要改善的地方。 如果您在使用中有任何的意见/建议甚至获取失败都可以QQ或者发邮件联系我。

使用方法

直接使用URL参数的形式调用即可。

                            http://{domain}/?url={url}
                        

也可使用size参数或@方式指定缩略图的尺寸。

                        	http://{domain}/?url={url}&size={size}
                        	
http://{domain}/?url={url}@{size}

例如

                            http://api.byi.pw/sitethumb/?url=blog.icewingcc.com
                            
http://api.byi.pw/sitethumb/?url=blog.icewingcc.com&size=X
http://st.byi.pw/?url=blog.icewingcc.com@X

参数列表

参数 描述

{domain}

目前可用的域名有:

  • api.byi.pw/sitethumb
  • st.byi.pw

{url}

required

需要获取截图的网站网址,可以为任意能访问的网址(目前不支持墙外)。

仅支持HTTP/HTTPS协议的网址,协议可省略。

提示:

如果因网站无法访问等原因导致截图失败,失败的网址十分钟内不允许再次获取。

{size}

optional

可选参数。返回的图标的尺寸,默认是M

目前支持的尺寸有:

  • T Tiny, 90 x 68 pixels
  • S Small, 120 x 90 pixels
  • M Medium, 200 x 150 pixels
  • L Large, 400 x 300 pixels
  • X ExtraL, 480 x 360 pixels

警告:

由于自API上线以来发现很多的滥用现象(主要是使用机器PUSH大量任务到服务器,使服务器堆积数以万计的任务无法完成,从而大大影响其他用户的使用),故而决定对单位时间内的新请求的数量加以限制,并在超出限制时返回503错误码。响应仍会显示失败图片,但HTTP Header为503。

更新历史

2015年8月16日 服务停止开放

  • 因为服务器资源占用等因素(目前服务器是与朋友合租且共用的)不得不停止接口的对外开放
  • 程序的第一个开源版本的代码正在整理中,请关注我的博客以获取软件开发的动态

2015年3月30日 版本 2.0.3

  • 添加查看当前服务器队列中未完成任务数量的接口
  • 针对滥用接口的现象加以限制,设置单位时间内允许添加任务的数量
  • 延长载入页面完成后与开始截图之间的时间间隔为0.5秒(之前是0.2秒)

2015年3月26日 版本 2.0.2 Beta

  • 修复请求资源超时失败时会截取全站造成内存占用过多的错误。
  • 修复网站无法打开时判断错误的BUG。
  • 添加请求失败时的默认图片。

2015年3月25日 版本 2.0.1 Beta

  • 修复2.0版本中出现的队列有时无法执行的BUG。
  • 使用resque执行任务,稳定性更高(2.0版本是用HTTP方式触发任务)。
  • 目前仍处于测试版本,暂时只开一个线程处理队列,测试稳定后再增加线程。

2015年3月23日 版本 2.0

  • 重新设计的程序架构,任务处理更快,流程更简单。
  • 使用多线程及消息队列的方式对接收的请求依次处理,保证服务器的稳定性。
  • 对请求失败的网址采取短时间内屏蔽其生成的方法,以避免线程长时间卡在失败的请求上造成返回缓慢。

2015年3月15日 版本 1.1

  • 修改后的第一个版本上线,修复初始版本的多个错误。
  • 修改缓存方式及API调用方式(尚不完善)。
  • 将API的域名独立出来使用st.byi.pw。

2015年2月4日 版本 1.0

  • 第一个版本上线测试。