The App Garden |
flickr.contacts.getList
Get a list of contacts for the calling user.
Authentication
This method requiresauthentication with 'read' permission.
Arguments
api_key(Required)- Your API application key.See here for more details.
filter(Optional)- An optional filter of the results. The following values are valid:
friendsfamilybothneither
- Only contacts who are friends (and not family)
- Only contacts who are family (and not friends)
- Only contacts who are both friends and family
- Only contacts who are neither friends nor family
page(Optional)- The page of results to return. If this argument is omitted, it defaults to 1.
per_page(Optional)- Number of photos to return per page. If this argument is omitted, it defaults to 1000. The maximum allowed value is 1000.
sort(Optional)- The order in which to sort the returned contacts. Defaults to name. The possible values are: name and time.
Example Response
<contactspage="1"pages="1"perpage="1000"total="3"> <contactnsid="12037949629@N01"username="Eric"iconserver="1"realname="Eric Costello"friend="1"family="0"ignored="1" /> <contactnsid="12037949631@N01"username="neb"iconserver="1"realname="Ben Cerveny"friend="0"family="0"ignored="0" /> <contactnsid="41578656547@N01"username="cal_abc"iconserver="1"realname="Cal Henderson"friend="1"family="1"ignored="0" /></contacts>
Error Codes
1: Invalid sort parameter.- The possible values are: name and time.
95: SSL is required- SSL is required to access the Flickr API.
96: Invalid signature- The passed signature was invalid.
97: Missing signature- The call required signing but no signature was sent.
98: Login failed / Invalid auth token- The login details or auth token passed were invalid.
99: User not logged in / Insufficient permissions- The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100: Invalid API Key- The API key passed was not valid or has expired.
105: Service currently unavailable- The requested service is temporarily unavailable.
106: Write operation failed- The requested operation failed due to a temporary issue.
111: Format "xxx" not found- The requested response format was not found.
112: Method "xxx" not found- The requested method was not found.
114: Invalid SOAP envelope- The SOAP envelope send in the request could not be parsed.
115: Invalid XML-RPC Method Call- The XML-RPC request document could not be parsed.
116: Bad URL found- One or more arguments contained a URL that has been used for abuse on Flickr.