CSSmania开放API

October 4, 2008 · Filed Under CSS · 6 Comments 

CSSmania是国外的很优秀的 Web Design Gallery 站点。上次给大家介绍的几个站点,CSSmania就是其中一个很出色的站点。

刚刚上了CSSmania,发现其官方开放了API,现在翻译一下文章(原文见此)。

一年半前,我们就收到了很多访问者的邮件,要求我们开放一些API,因为没有办法去直接从缩略图看到网站的信息,只能独立的去访问缩略图所带的链接。

我们不能回复这些邮件,因为我们在过去的16个月里,已经说得很清楚了:“我们会在以后推出这个功能。”现在,我想,这个“以后”就是现在!

所以,我们就推出了全新的API,Luis Sacristán 给了很大的帮助!他帮助我们调试了一些Bug,使得现在的API能够如此平滑流畅。

CSS Mania’s API 是一个不会终止的API。他能够根据我们访问者的爱好而改变。根据访问者的反馈,我们会在未来的版本中增加更多的数据,如果访问真需要的话。所以,请尽情的联系我们,尽情的享受这个API。请一定要慎重的读一读我们的使用限制,现在还没有法律上的使用限制。但是,如果某个IP很不友好的使用这个API时,这个IP很有可能会被我们的服务器屏蔽。

因此,如果你想要通过我们的API制作一个AIR widdget,就动手做吧!因为我们可能会给你一个惊喜,如果我们喜欢你这个东西的话。

下面一篇文章,我会翻译CSSmania API 的一些接口知识

CSSmania的API

October 4, 2008 · Filed Under CSS · 2 Comments 

HTTP method & 编码问题

CSSmania的API只支持 GET method 和 UTF-8 的编码。

速率限制 & 时间戳

目前还没有任何速度的限制,但是如果滥用API的话,服务器可能会被永久屏蔽。

时间格式为:YYYY-MM-DD HH:mm:ss

API Key & 格式

不需要API Key(如果不需要使用CSSmania截图的话),如果需要截图,请联系官方

目前返回的格式为JSON。

使用API

格式:http://cssmania.com/api/api.php?search=xxxxxxxxxxxxx
搜索的参数最少是7个字符。
得到的数据是JSON格式,如下:

[{"id":"5865","url":"http:\/\/www.authenticjobs.com\/",
"developed":"Cameron Moll",
"developed_url":"http:\/\/www.cameronmoll.com\/","country":"U.S",
"rating":"5","totalscore":"104",
"numbervotes":"20",
 "colours_0":"f0f0e0",
"colours_1":"e0e0e0","colours_2":602000,
"colours_3":600000,"colours_4":"f0e0e0", 
"url_screenshot":"http:\/\/cssmania.com\/screenshots\/authenticjobscom.jpg",
"time_created":"2006-09-28 14:05:38", 
"last_screenshot_version":"2006-09-28 14:14:22"},{"id":"9979",
"url":"http:\/\/www.authenticstyle.co.uk\/",
"developed":"William Smith",
"developed_url":"http:\/\/www.authenticstyle.co.uk\/",
"country":"United Kingdom","rating":"6","totalscore":"56",
"numbervotes":"9","colours_0":202000,
"colours_1":200000,"colours_2":202020,"colours_3":"000000",
"colours_4":606060,
 "url_screenshot":
"http:\/\/cssmania.com\/screenshots\/authenticstylecouk_fav.jpg",
"time_created":"2008-04-20 19:20:58",
"last_screenshot_version":"2008-04-20 19:21:17"}]
其中一些参数的说明:
id = 截图ID(for未来版本)
url = 截图URL
developed = 截图开发者
country = 开发者国籍
rating = 实际打分
totalscore = 总得票数
numbervotes = 票数排名
colours_0 … 5 = 设计中使用做多的5种颜色(RGB16进制)
url_screenshot = 在CSSmania服务器上的截图
time_created = 截图的创建时间
last_screenshot_version = 最近的截图版本
HTTP状态码:

200 OK: 正常

304 Not Modified: 无新数据

400 Bad Request: 请求没有经过验证

404 Not Found: 找不到资源

500 Internal Server Error: CSSmania服务器出错

503 Service Unavailable: CSSMania服务器忙,稍后再试。