AstroBin 的只读应用程序接口

简而言之

AstroBin实现了一套基本的RESTfulAPI，目前，这些API是只读的，它们允许你获取图像的数据，并进行一些基本的搜索。

使用AstroBin的API，你将能够创建你自己的网站，桌面或移动应用程序，使用AstroBin的一些内容。

一些可能性

  • 一个显示某个用户最近图片的网络小插件。

  • 一个显示“今日最佳”网络小工具。

  • 一个用于高效浏览AstroBin的iPhone/Android浏览器

  • ......等等！

可能性和使用限制

AstroBin 的应用程序接口目前仅限于检索基本信息和对图像进行简单搜索。

支持的响应类型有XML和JSON。

如何开始

首先您需要的是一个API KEY。请使用API Key申请表来获取。

如何显示图像

API 响应将为您提供多个url_*属性，每个属性代表不同的图像尺寸。

合理使用

不允许使用API无情地搜刮所有可用的内容。如果不遵守这一规定，将导致个人的API密钥被永久撤销。

请阅读服务条款中的 API 部分。

一些例子

请注意：所有的例子都省略了基础URL、认证参数和格式参数。你必须记得在实际使用中包含这些参数，例如：

http://astrobin.com/api/v1/.../?...&api_key=...&api_secret=...&format=json

请记住，你可以将这些查询中的大部分组合起来，放开手脚，自由尝试！

按 ID 获取单张图片：

image/1234/

按主题搜索：

image/?subjects=M31

# 注意：由于性能原因，按主题搜索的结果限制为 100 个。

按用户搜索：

image/?user=siovene

按不区分大小写、部分标题搜索：

image/?title__icontains=andromeda

按不区分大小写、部分描述搜索：

image/?description__icontains=wind

其他有用的小技巧：

__startswith=起始处
__endswith=结束
__包含=
__开始于=
__起点= __终点=

按上传日期范围搜索：

image/?uploaded__gte=2012-04-10%200:00:00&uploaded__lt=2012-04-11%200:00:00

比较运算符：

__lt=_lte=__________________。
__lte=__gt=__lt
__gt=
__gte=（格式

获得今天的"今日最佳"：

imageoftheday/?limit=1

获取昨天的"今日最佳"：

imageoftheday/?limit=1&offset=1

获取热门推荐：

toppick/

获得最佳提名：

topppicknomination/

通过ID获取用户：

userprofile/1234

通过用户名获取用户：

userprofile/?username=siovene

社区图书馆

社区应用程序和小工具