The App GardenCreate an App API Documentation Feeds What is the App Garden? |
flickr.people.getGroups
Returns the list of groups a user is a member of.
Authentication
This method requires authentication with 'read' permission.
Arguments
api_key
(Required)- Your API application key. See here for more details.
user_id
(Required)- The NSID of the user to fetch groups for.
extras
(Optional)- A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are:
privacy
,throttle
,restrictions
Example Response
<groups> <group nsid="17274427@N00" name="Cream of the Crop - Please read the rules" iconfarm="1" iconserver="1" admin="0" eighteenplus="0" invitation_only="0" members="11935" pool_count="12522" /> <group nsid="20083316@N00" name="Apple" iconfarm="1" iconserver="1" admin="0" eighteenplus="0" invitation_only="0" members="11776" pool_count="62438" /> <group nsid="34427469792@N01" name="FlickrCentral" iconfarm="1" iconserver="1" admin="0" eighteenplus="0" invitation_only="0" members="168055" pool_count="5280930" /> <group nsid="37718678610@N01" name="Typography and Lettering" iconfarm="1" iconserver="1" admin="0" eighteenplus="0" invitation_only="0" members="17318" pool_count="130169" /> </groups>The admin attribute indicates whether the user is an administrator of the group. The eighteenplus attribute indicates if the group is visible to members over 18 only. The invite_only attribute indicates whether a user can join the group without administrator approval.
Error Codes
1: User not found
- The user id passed did not match a Flickr user.
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.