說明使用 PHP 透過 flickr API 抓取使用者所有相片(flickr.people.getPhotos)的方法。
可以傳入的參數有這些:
api_key(必需的)- Your API application key. See here for more details.
user_id(必需的)- The NSID of the user who's photos to return. A value of "me" will return the calling user's photos.
safe_search(可選的)- Safe search setting:
- 1 for safe.
- 2 for moderate.
- 3 for restricted.
min_upload_date(可選的)- Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp.
max_upload_date(可選的)- Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp.
min_taken_date(可選的)- Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime.
max_taken_date(可選的)- Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime.
content_type(可選的)- Content Type setting:
- 1 for photos only.
- 2 for screenshots only.
- 3 for 'other' only.
- 4 for photos and screenshots.
- 5 for screenshots and 'other'.
- 6 for photos and 'other'.
- 7 for photos, screenshots, and 'other' (all).
privacy_filter(可選的)- Return photos only matching a certain privacy level. This only applies when making an authenticated call to view photos you own. Valid values are:
- 1 public photos
- 2 private photos visible to friends
- 3 private photos visible to family
- 4 private photos visible to friends & family
- 5 completely private photos
extras(可選的)- A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are:
description,license,date_upload,date_taken,owner_name,icon_server,original_format,last_update,geo,tags,machine_tags,o_dims,views,media,path_alias,url_sq,url_t,url_s,url_q,url_m,url_n,url_z,url_c,url_l,url_o per_page(可選的)- Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page(可選的)- The page of results to return. If this argument is omitted, it defaults to 1.
回傳的內容大概會長這樣
<photos page="2" pages="89" perpage="10" total="881">
<photo id="2636" owner="47058503995@N01"
secret="a123456" server="2" title="test_04"
ispublic="1" isfriend="0" isfamily="0" />
<photo id="2635" owner="47058503995@N01"
secret="b123456" server="2" title="test_03"
ispublic="0" isfriend="1" isfamily="1" />
<photo id="2633" owner="47058503995@N01"
secret="c123456" server="2" title="test_01"
ispublic="1" isfriend="0" isfamily="0" />
<photo id="2610" owner="12037949754@N01"
secret="d123456" server="2" title="00_tall"
ispublic="1" isfriend="0" isfamily="0" />
</photos>
API 說明
flickr.people.getPhotos