yupoo.photos.search

返回符合某些条件的照片列表.只有对于用户可见的照片才被返回.

要返回私人照片,调用该方法的用户必须被认证并有读的权限.未被

认证的调用只能返回公开照片.

使用该方法,如果搜索的不是自己的照片,将只能搜索到该用户的前200张照片.

认证

该方法不需要认证

参数

该方法的参数都不是必须的,但至少得传一个参数。

名称 是否必需 意思
api_key 必需 你的API key
api_sig 必需 签名, 请参考如何签名
user_id 可选 要搜索照片的所有者ID,如果没有匹配,则返回所有公共照片
tags 可选 一个逗号间隔的标签列表,含有该标签的照片将返回
text 可选 搜索内容,照片的标题,描述或者是标签包含这个内容的照片将被返回
per_page 可选 每页的照片数目,默认是100,最大为500
page 可选 要返回的页码,默认为1

返回结果例子

<result page="1" perpage="500" pages="1" total="3">
    <photos>
        <photo id="1912190-49806947" owner="1912190" ownername="wuha449" title="r10" bucket="wuha449" key="778836222258" host="0" dir="wuha449" filename="778836222258"/>
        <photo id="371672-61861809" owner="371672" ownername="bsdede" title="里克尔梅" bucket="bsdede" key="3edb12424aae" host="0" dir="bsdede" filename="3edb12424aae"/>
        <photo id="128220-1096483" owner="128220" ownername="ludi3170" title="10" bucket="ludi3170" key="1eb2cd647005" host="0" dir="ludi3170" filename="1eb2cd647005"/>
    </photos>
</result>

如何将结果中photo这个元素转化成url地址,请看这里

错误代号

代号 消息 解释
1 Too many tags in ALL query 当执行标签搜索时,不能指定超过20个的标签
2 User not found 指定用户不存在
3 Parameterless searches have been disabled 执行了没有参数的搜索