听者有心 » API

CSSmania开放API

soz — Sat, 04 Oct 2008 12:56:51 +0000

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

soz — Sat, 04 Oct 2008 12:47:45 +0000

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服务器忙，稍后再试。