/dist/federated-dashboard-flickr-widget.js

Large files files are truncated, but you can click here to view the full file

(function(underscore) {
  'use strict';

  window.namespace = function(string, obj) {
    var current = window,
        names = string.split('.'),
        name;

    while((name = names.shift())) {
      current[name] = current[name] || {};
      current = current[name];
    }

    underscore.extend(current, obj);

  };

}(window._));

(function() {
 var Utils = {};
Utils.formQueryString = function (queryArguments) {
    var args = [],
        append = function(key) {
          args.push(key + "=" + queryArguments[key]);
        };
    Object.keys(queryArguments).sort().forEach(append);
    return args.join("&");
  };
Utils.checkRequirements = function (method_name, required, callOptions, callback) {
    required = required || [];
    for(var r=0, last=required.length, arg; r<last; r++) {
      arg = required[r];
      if(arg.name === "api_key") continue;
      if(!callOptions.hasOwnProperty(arg.name)) {
        return callback(new Error("missing required argument '"+arg.name+"' in call to "+method_name));
      }
    }
  };
Utils.generateAPIFunction = function (method) {
    return function(callOptions, callback) {
      if(callOptions && !callback) { callback = callOptions; callOptions = {}; }
      var queryArguments = Utils.generateQueryArguments(method.name, this.flickrOptions, callOptions);
      Utils.queryFlickr(queryArguments, this.flickrOptions, method.security, callback);
    };
  };
Utils.generateAPIDevFunction = function (method) {
    return function(callOptions, callback) {
      if(callOptions && !callback) { callback = callOptions; callOptions = {}; }
      Utils.checkRequirements(method.name, method.required, callOptions, callback);
      var queryArguments = Utils.generateQueryArguments(method.name, this.flickrOptions, callOptions);
      Utils.queryFlickr(queryArguments, this.flickrOptions, method.security, callback, method.errors);
    };
  };
Utils.generateQueryArguments = function (method_name, flickrOptions, callOptions) {
    // set up authorized method access
    var queryArguments = {
      method: method_name,
      format: "json",
    };
    if(flickrOptions.api_key) {
      queryArguments.api_key = flickrOptions.api_key;
    }
    // set up bindings for method-specific args
    Object.keys(callOptions).forEach(function(key) {
      queryArguments[key] = callOptions[key];
    });
    return queryArguments;
  };
Utils.queryFlickr = function (queryArguments, flickrOptions, security, processResult) {
    if(flickrOptions.endpoint) {
      return this.queryProxyEndpoint(queryArguments, flickrOptions, processResult);
    }
    return this.queryFlickrAPI(queryArguments, flickrOptions, security, processResult);
  };
Utils.queryFlickrAPI = function (queryArguments, flickrOptions, security, processResult) {
    var url = "https://api.flickr.com/services/rest/",
        queryString = this.formQueryString(queryArguments),
        flickrURL = url + "?" + queryString;
    // Do we need special permissions? (read private, 1, write, 2, or delete, 3)?
    // if so, those are currently not supported. Send an error-notification.
    if(security.requiredperms > 0) {
      return processResult(new Error("signed calls (write/delete) currently not supported"));
    }
    this.handleURLRequest("GET", flickrURL, processResult);
  };
Utils.queryProxyEndpoint = function (queryArguments, flickrOptions, processResult) {
    var queryString = this.formQueryString(queryArguments),
        url = flickrOptions.endpoint + "?" + queryString;
    this.handleURLRequest("POST", url, processResult, queryArguments);
  };
Utils.handleURLRequest = function (verb, url, processResult, postdata) {
    var xhr = new XMLHttpRequest();
    xhr.open(verb, url, true);
    if(postdata) {
      xhr.setRequestHeader("Content-Type", "application/json");
    }
    xhr.onreadystatechange = function() {
      if(xhr.readyState === 4) {
        if(xhr.status == 200) {
          var error = false,
              body = xhr.responseText;
          // we get a response, but there's no response body. That's a problem.
          if(!body) {
            error = "HTTP Error " + response.statusCode + " (" + statusCodes[response.statusCode] + ")";
            return processResult(error);
          }
          // we get a response, and there were no errors
          if(!error) {
            try {
              body = body.replace(/^jsonFlickrApi\(/,'').replace(/\}\)$/,'}');
              body = JSON.parse(body);
              if(body.stat !== "ok") {
                // There was a request error, and the JSON .stat property
                // will tell us what that error was.
                return processResult(body.message);
              }
            } catch (e) {
              // general JSON error
              return processResult("could not parse body as JSON");
            }
          }
          // Some kind of other error occurred. Simply call the process
          // handler blindly with both the error and error body.
          processResult(error, body);
        }
        else { processResult("HTTP status not 200 (received "+xhr.status+")"); }
      }
    };
    xhr.send(postdata ? JSON.stringify(postdata) : null);
  };
 Utils.errors = {
    "96": {
        "code": 96,
        "message": "Invalid signature",
        "_content": "The passed signature was invalid."
    },
    "97": {
        "code": 97,
        "message": "Missing signature",
        "_content": "The call required signing but no signature was sent."
    },
    "98": {
        "code": 98,
        "message": "Login failed / Invalid auth token",
        "_content": "The login details or auth token passed were invalid."
    },
    "99": {
        "code": 99,
        "message": "User not logged in / Insufficient permissions",
        "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions."
    },
    "100": {
        "code": 100,
        "message": "Invalid API Key",
        "_content": "The API key passed was not valid or has expired."
    },
    "105": {
        "code": 105,
        "message": "Service currently unavailable",
        "_content": "The requested service is temporarily unavailable."
    },
    "106": {
        "code": 106,
        "message": "Write operation failed",
        "_content": "The requested operation failed due to a temporary issue."
    },
    "108": {
        "code": "108",
        "message": "Invalid frob",
        "_content": "The specified frob does not exist or has already been used."
    },
    "111": {
        "code": 111,
        "message": "Format \"xxx\" not found",
        "_content": "The requested response format was not found."
    },
    "112": {
        "code": 112,
        "message": "Method \"xxx\" not found",
        "_content": "The requested method was not found."
    },
    "114": {
        "code": 114,
        "message": "Invalid SOAP envelope",
        "_content": "The SOAP envelope send in the request could not be parsed."
    },
    "115": {
        "code": 115,
        "message": "Invalid XML-RPC Method Call",
        "_content": "The XML-RPC request document could not be parsed."
    },
    "116": {
        "code": 116,
        "message": "Bad URL found",
        "_content": "One or more arguments contained a URL that has been used for abuse on Flickr."
    }
};
 var Flickr = function (flickrOptions) {
  this.bindOptions(flickrOptions);
};
 Flickr.prototype = {};
 Flickr.methods = {
 "flickr.activity.userComments": {
  "optional": [
   {
    "name": "per_page",
    "_content": "Number of items to return per page. If this argument is omitted, it defaults to 10. The maximum allowed value is 50."
   },
   {
    "name": "page",
    "_content": "The page of results to return. If this argument is omitted, it defaults to 1."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 1
  },
  "name": "flickr.activity.userComments",
  "url": "https://www.flickr.com/services/api/flickr.activity.userComments.html"
 },
 "flickr.activity.userPhotos": {
  "optional": [
   {
    "name": "timeframe",
    "_content": "The timeframe in which to return updates for. This can be specified in days (<code>'2d'</code>) or hours (<code>'4h'</code>). The default behavoir is to return changes since the beginning of the previous user session."
   },
   {
    "name": "per_page",
    "_content": "Number of items to return per page. If this argument is omitted, it defaults to 10. The maximum allowed value is 50."
   },
   {
    "name": "page",
    "_content": "The page of results to return. If this argument is omitted, it defaults to 1."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 1
  },
  "name": "flickr.activity.userPhotos",
  "url": "https://www.flickr.com/services/api/flickr.activity.userPhotos.html"
 },
 "flickr.auth.checkToken": {
  "required": [
   {
    "name": "auth_token",
    "_content": "The authentication token to check."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.auth.checkToken",
  "url": "https://www.flickr.com/services/api/flickr.auth.checkToken.html"
 },
 "flickr.auth.getFrob": {
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.auth.getFrob",
  "url": "https://www.flickr.com/services/api/flickr.auth.getFrob.html"
 },
 "flickr.auth.getFullToken": {
  "required": [
   {
    "name": "mini_token",
    "_content": "The mini-token typed in by a user. It should be 9 digits long. It may optionally contain dashes."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Mini-token not found",
    "_content": "The passed mini-token was not valid."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.auth.getFullToken",
  "url": "https://www.flickr.com/services/api/flickr.auth.getFullToken.html"
 },
 "flickr.auth.getToken": {
  "required": [
   {
    "name": "frob",
    "_content": "The frob to check."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.auth.getToken",
  "url": "https://www.flickr.com/services/api/flickr.auth.getToken.html"
 },
 "flickr.auth.oauth.checkToken": {
  "required": [
   {
    "name": "oauth_token",
    "_content": "The OAuth authentication token to check."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 1,
   "requiredperms": 0
  },
  "name": "flickr.auth.oauth.checkToken",
  "url": "https://www.flickr.com/services/api/flickr.auth.oauth.checkToken.html"
 },
 "flickr.auth.oauth.getAccessToken": {
  "security": {
   "needslogin": 0,
   "needssigning": 1,
   "requiredperms": 0
  },
  "name": "flickr.auth.oauth.getAccessToken",
  "url": "https://www.flickr.com/services/api/flickr.auth.oauth.getAccessToken.html"
 },
 "flickr.blogs.getList": {
  "optional": [
   {
    "name": "service",
    "_content": "Optionally only return blogs for a given service id.  You can get a list of from <a href=\"/services/api/flickr.blogs.getServices.html\">flickr.blogs.getServices()</a>."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 1
  },
  "name": "flickr.blogs.getList",
  "url": "https://www.flickr.com/services/api/flickr.blogs.getList.html"
 },
 "flickr.blogs.getServices": {
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.blogs.getServices",
  "url": "https://www.flickr.com/services/api/flickr.blogs.getServices.html"
 },
 "flickr.blogs.postPhoto": {
  "required": [
   {
    "name": "photo_id",
    "_content": "The id of the photo to blog"
   },
   {
    "name": "title",
    "_content": "The blog post title"
   },
   {
    "name": "description",
    "_content": "The blog post body"
   }
  ],
  "optional": [
   {
    "name": "blog_id",
    "_content": "The id of the blog to post to."
   },
   {
    "name": "blog_password",
    "_content": "The password for the blog (used when the blog does not have a stored password)."
   },
   {
    "name": "service",
    "_content": "A Flickr supported blogging service.  Instead of passing a blog id you can pass a service id and we'll post to the first blog of that service we find."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Blog not found",
    "_content": "The blog id was not the id of a blog belonging to the calling user"
   },
   {
    "code": "2",
    "message": "Photo not found",
    "_content": "The photo id was not the id of a public photo"
   },
   {
    "code": "3",
    "message": "Password needed",
    "_content": "A password is not stored for the blog and one was not passed with the request"
   },
   {
    "code": "4",
    "message": "Blog post failed",
    "_content": "The blog posting failed (a blogging API failure of some sort)"
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.blogs.postPhoto",
  "url": "https://www.flickr.com/services/api/flickr.blogs.postPhoto.html"
 },
 "flickr.cameras.getBrandModels": {
  "required": [
   {
    "name": "brand",
    "_content": "The ID of the requested brand (as returned from flickr.cameras.getBrands)."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Brand not found",
    "_content": "Unable to find the given brand ID."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.cameras.getBrandModels",
  "url": "https://www.flickr.com/services/api/flickr.cameras.getBrandModels.html"
 },
 "flickr.cameras.getBrands": {
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.cameras.getBrands",
  "url": "https://www.flickr.com/services/api/flickr.cameras.getBrands.html"
 },
 "flickr.collections.getInfo": {
  "required": [
   {
    "name": "collection_id",
    "_content": "The ID of the collection to fetch information for."
   }
  ],
  "optional": [
   {
    "name": "secure_image_embeds",
    "_content": "This argument will secure the external image embeds in all the markup and return a secure<Field> back in addition to the <Field>"
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Collection not found",
    "_content": "The requested collection could not be found or is not visible to the calling user."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 1
  },
  "name": "flickr.collections.getInfo",
  "url": "https://www.flickr.com/services/api/flickr.collections.getInfo.html"
 },
 "flickr.collections.getTree": {
  "optional": [
   {
    "name": "collection_id",
    "_content": "The ID of the collection to fetch a tree for, or zero to fetch the root collection. Defaults to zero."
   },
   {
    "name": "user_id",
    "_content": "The ID of the account to fetch the collection tree for. Deafults to the calling user."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "User not found",
    "_content": "The specified user could not be found."
   },
   {
    "code": "2",
    "message": "Collection not found",
    "_content": "The specified collection does not exist."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.collections.getTree",
  "url": "https://www.flickr.com/services/api/flickr.collections.getTree.html"
 },
 "flickr.commons.getInstitutions": {
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.commons.getInstitutions",
  "url": "https://www.flickr.com/services/api/flickr.commons.getInstitutions.html"
 },
 "flickr.contacts.getList": {
  "optional": [
   {
    "name": "filter",
    "_content": "An optional filter of the results. The following values are valid:<br />\r\n&nbsp;\r\n<dl>\r\n\t<dt><b><code>friends</code></b></dt>\r\n\t<dl>Only contacts who are friends (and not family)</dl>\r\n\r\n\t<dt><b><code>family</code></b></dt>\r\n\t<dl>Only contacts who are family (and not friends)</dl>\r\n\r\n\t<dt><b><code>both</code></b></dt>\r\n\t<dl>Only contacts who are both friends and family</dl>\r\n\r\n\t<dt><b><code>neither</code></b></dt>\r\n\t<dl>Only contacts who are neither friends nor family</dl>\r\n</dl>"
   },
   {
    "name": "page",
    "_content": "The page of results to return. If this argument is omitted, it defaults to 1."
   },
   {
    "name": "per_page",
    "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 1000. The maximum allowed value is 1000."
   },
   {
    "name": "sort",
    "_content": "The order in which to sort the returned contacts. Defaults to name. The possible values are: name and time."
   },
   {
    "name": "fields",
    "_content": "The fields can have the following args:\r\nrealname, friend, family,path_alias,location,public_photos_count,can_tag"
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Invalid sort parameter.",
    "_content": "The possible values are: name and time."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 1
  },
  "name": "flickr.contacts.getList",
  "url": "https://www.flickr.com/services/api/flickr.contacts.getList.html"
 },
 "flickr.contacts.getListRecentlyUploaded": {
  "optional": [
   {
    "name": "date_lastupload",
    "_content": "Limits the resultset to contacts that have uploaded photos since this date. The date should be in the form of a Unix timestamp.\r\n\r\nThe default offset is (1) hour and the maximum (24) hours. "
   },
   {
    "name": "filter",
    "_content": "Limit the result set to all contacts or only those who are friends or family. Valid options are:\r\n\r\n<ul>\r\n<li><strong>ff</strong> friends and family</li>\r\n<li><strong>all</strong> all your contacts</li>\r\n</ul>\r\nDefault value is \"all\"."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 1
  },
  "name": "flickr.contacts.getListRecentlyUploaded",
  "url": "https://www.flickr.com/services/api/flickr.contacts.getListRecentlyUploaded.html"
 },
 "flickr.contacts.getPublicList": {
  "required": [
   {
    "name": "user_id",
    "_content": "The NSID of the user to fetch the contact list for."
   }
  ],
  "optional": [
   {
    "name": "page",
    "_content": "The page of results to return. If this argument is omitted, it defaults to 1."
   },
   {
    "name": "per_page",
    "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 1000. The maximum allowed value is 1000."
   },
   {
    "name": "show_more",
    "_content": "Include additional information for each contact, such as realname, is_friend, is_family, path_alias and location."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "User not found",
    "_content": "The specified user NSID was not a valid user."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.contacts.getPublicList",
  "url": "https://www.flickr.com/services/api/flickr.contacts.getPublicList.html"
 },
 "flickr.contacts.getTaggingSuggestions": {
  "optional": [
   {
    "name": "include_self",
    "_content": "Return calling user in the list of suggestions. Default: true."
   },
   {
    "name": "include_address_book",
    "_content": "Include suggestions from the user's address book. Default: false"
   },
   {
    "name": "per_page",
    "_content": "Number of contacts to return per page. If this argument is omitted, all contacts will be returned."
   },
   {
    "name": "page",
    "_content": "The page of results to return. If this argument is omitted, it defaults to 1."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 1
  },
  "name": "flickr.contacts.getTaggingSuggestions",
  "url": "https://www.flickr.com/services/api/flickr.contacts.getTaggingSuggestions.html"
 },
 "flickr.favorites.add": {
  "required": [
   {
    "name": "photo_id",
    "_content": "The id of the photo to add to the user's favorites."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Photo not found",
    "_content": "The photo id passed was not a valid photo id."
   },
   {
    "code": "2",
    "message": "Photo is owned by you",
    "_content": "The photo belongs to the user and so cannot be added to their favorites."
   },
   {
    "code": "3",
    "message": "Photo is already in favorites",
    "_content": "The photo is already in the user's list of favorites."
   },
   {
    "code": "4",
    "message": "User cannot see photo",
    "_content": "The user does not have permission to add the photo to their favorites."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.favorites.add",
  "url": "https://www.flickr.com/services/api/flickr.favorites.add.html"
 },
 "flickr.favorites.getContext": {
  "required": [
   {
    "name": "photo_id",
    "_content": "The id of the photo to fetch the context for."
   },
   {
    "name": "user_id",
    "_content": "The user who counts the photo as a favorite."
   }
  ],
  "optional": [
   {
    "name": "num_prev",
    "_content": ""
   },
   {
    "name": "num_next",
    "_content": ""
   },
   {
    "name": "extras",
    "_content": "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_m, url_z, url_l, url_o"
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Photo not found",
    "_content": "The photo id passed was not a valid photo id, or was the id of a photo that the calling user does not have permission to view."
   },
   {
    "code": "2",
    "message": "User not found",
    "_content": "The specified user was not found."
   },
   {
    "code": "3",
    "message": "Photo not a favorite",
    "_content": "The specified photo is not a favorite of the specified user."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.favorites.getContext",
  "url": "https://www.flickr.com/services/api/flickr.favorites.getContext.html"
 },
 "flickr.favorites.getList": {
  "optional": [
   {
    "name": "user_id",
    "_content": "The NSID of the user to fetch the favorites list for. If this argument is omitted, the favorites list for the calling user is returned."
   },
   {
    "name": "jump_to",
    "_content": ""
   },
   {
    "name": "min_fave_date",
    "_content": "Minimum date that a photo was favorited on. The date should be in the form of a unix timestamp."
   },
   {
    "name": "max_fave_date",
    "_content": "Maximum date that a photo was favorited on. The date should be in the form of a unix timestamp."
   },
   {
    "name": "get_user_info",
    "_content": "Include info for the user who's favorites are being returned."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "User not found",
    "_content": "The specified user NSID was not a valid flickr user."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 1
  },
  "name": "flickr.favorites.getList",
  "url": "https://www.flickr.com/services/api/flickr.favorites.getList.html"
 },
 "flickr.favorites.getPublicList": {
  "required": [
   {
    "name": "user_id",
    "_content": "The user to fetch the favorites list for."
   }
  ],
  "optional": [
   {
    "name": "jump_to",
    "_content": ""
   },
   {
    "name": "min_fave_date",
    "_content": "Minimum date that a photo was favorited on. The date should be in the form of a unix timestamp."
   },
   {
    "name": "max_fave_date",
    "_content": "Maximum date that a photo was favorited on. The date should be in the form of a unix timestamp."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "User not found",
    "_content": "The specified user NSID was not a valid flickr user."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.favorites.getPublicList",
  "url": "https://www.flickr.com/services/api/flickr.favorites.getPublicList.html"
 },
 "flickr.favorites.remove": {
  "required": [
   {
    "name": "photo_id",
    "_content": "The id of the photo to remove from the user's favorites."
   }
  ],
  "optional": [
   {
    "name": "user_id",
    "_content": "NSID of the user whose favorites the photo should be removed from. This only works if the calling user owns the photo."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Photo not in favorites",
    "_content": "The photo id passed was not in the user's favorites."
   },
   {
    "code": "2",
    "message": "Cannot remove photo from that user's favorites",
    "_content": "user_id was passed as an argument, but photo_id is not owned by the authenticated user."
   },
   {
    "code": "3",
    "message": "User not found",
    "_content": "Invalid user_id argument."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.favorites.remove",
  "url": "https://www.flickr.com/services/api/flickr.favorites.remove.html"
 },
 "flickr.galleries.addPhoto": {
  "required": [
   {
    "name": "gallery_id",
    "_content": "The ID of the gallery to add a photo to.  Note: this is the compound ID returned in methods like <a href=\"/services/api/flickr.galleries.getList.html\">flickr.galleries.getList</a>, and <a href=\"/services/api/flickr.galleries.getListForPhoto.html\">flickr.galleries.getListForPhoto</a>."
   },
   {
    "name": "photo_id",
    "_content": "The photo ID to add to the gallery"
   }
  ],
  "optional": [
   {
    "name": "comment",
    "_content": "A short comment or story to accompany the photo."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Required parameter missing",
    "_content": "One or more required parameters was not included with your API call."
   },
   {
    "code": "2",
    "message": "Invalid gallery ID",
    "_content": "That gallery could not be found."
   },
   {
    "code": "3",
    "message": "Invalid photo ID",
    "_content": "The requested photo could not be found."
   },
   {
    "code": "4",
    "message": "Invalid comment",
    "_content": "The comment body could not be validated."
   },
   {
    "code": "5",
    "message": "Failed to add photo",
    "_content": "Unable to add the photo to the gallery."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.galleries.addPhoto",
  "url": "https://www.flickr.com/services/api/flickr.galleries.addPhoto.html"
 },
 "flickr.galleries.create": {
  "required": [
   {
    "name": "title",
    "_content": "The name of the gallery"
   },
   {
    "name": "description",
    "_content": "A short description for the gallery"
   }
  ],
  "optional": [
   {
    "name": "primary_photo_id",
    "_content": "The first photo to add to your gallery"
   },
   {
    "name": "full_result",
    "_content": "Get the result in the same format as galleries.getList"
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Required parameter missing",
    "_content": "One or more of the required parameters was missing from your API call."
   },
   {
    "code": "2",
    "message": "Invalid title or description",
    "_content": "The title or the description could not be validated."
   },
   {
    "code": "3",
    "message": "Failed to add gallery",
    "_content": "There was a problem creating the gallery."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.galleries.create",
  "url": "https://www.flickr.com/services/api/flickr.galleries.create.html"
 },
 "flickr.galleries.editMeta": {
  "required": [
   {
    "name": "gallery_id",
    "_content": "The gallery ID to update."
   },
   {
    "name": "title",
    "_content": "The new title for the gallery."
   }
  ],
  "optional": [
   {
    "name": "description",
    "_content": "The new description for the gallery."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Required parameter missing",
    "_content": "One or more required parameters was missing from your request."
   },
   {
    "code": "2",
    "message": "Invalid title or description",
    "_content": "The title or description arguments could not be validated."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.galleries.editMeta",
  "url": "https://www.flickr.com/services/api/flickr.galleries.editMeta.html"
 },
 "flickr.galleries.editPhoto": {
  "required": [
   {
    "name": "gallery_id",
    "_content": "The ID of the gallery to add a photo to. Note: this is the compound ID returned in methods like flickr.galleries.getList, and flickr.galleries.getListForPhoto."
   },
   {
    "name": "photo_id",
    "_content": "The photo ID to add to the gallery."
   },
   {
    "name": "comment",
    "_content": "The updated comment the photo."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Invalid gallery ID",
    "_content": "That gallery could not be found."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.galleries.editPhoto",
  "url": "https://www.flickr.com/services/api/flickr.galleries.editPhoto.html"
 },
 "flickr.galleries.editPhotos": {
  "required": [
   {
    "name": "gallery_id",
    "_content": "The id of the gallery to modify. The gallery must belong to the calling user."
   },
   {
    "name": "primary_photo_id",
    "_content": "The id of the photo to use as the 'primary' photo for the gallery. This id must also be passed along in photo_ids list argument."
   },
   {
    "name": "photo_ids",
    "_content": "A comma-delimited list of photo ids to include in the gallery. They will appear in the set in the order sent. This list must contain the primary photo id. This list of photos replaces the existing list."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.galleries.editPhotos",
  "url": "https://www.flickr.com/services/api/flickr.galleries.editPhotos.html"
 },
 "flickr.galleries.getInfo": {
  "required": [
   {
    "name": "gallery_id",
    "_content": "The gallery ID you are requesting information for."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.galleries.getInfo",
  "url": "https://www.flickr.com/services/api/flickr.galleries.getInfo.html"
 },
 "flickr.galleries.getList": {
  "required": [
   {
    "name": "user_id",
    "_content": "The NSID of the user to get a galleries list for. If none is specified, the calling user is assumed."
   }
  ],
  "optional": [
   {
    "name": "per_page",
    "_content": "Number of galleries to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500."
   },
   {
    "name": "page",
    "_content": "The page of results to return. If this argument is omitted, it defaults to 1."
   },
   {
    "name": "primary_photo_extras",
    "_content": "A comma-delimited list of extra information to fetch for the primary photo. Currently supported fields are: 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_m, url_o"
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.galleries.getList",
  "url": "https://www.flickr.com/services/api/flickr.galleries.getList.html"
 },
 "flickr.galleries.getListForPhoto": {
  "required": [
   {
    "name": "photo_id",
    "_content": "The ID of the photo to fetch a list of galleries for."
   }
  ],
  "optional": [
   {
    "name": "per_page",
    "_content": "Number of galleries to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500."
   },
   {
    "name": "page",
    "_content": "The page of results to return. If this argument is omitted, it defaults to 1."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.galleries.getListForPhoto",
  "url": "https://www.flickr.com/services/api/flickr.galleries.getListForPhoto.html"
 },
 "flickr.galleries.getPhotos": {
  "required": [
   {
    "name": "gallery_id",
    "_content": "The ID of the gallery of photos to return"
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.galleries.getPhotos",
  "url": "https://www.flickr.com/services/api/flickr.galleries.getPhotos.html"
 },
 "flickr.groups.browse": {
  "optional": [
   {
    "name": "cat_id",
    "_content": "The category id to fetch a list of groups and sub-categories for. If not specified, it defaults to zero, the root of the category tree."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Category not found",
    "_content": "The value passed for cat_id was not a valid category id."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 1
  },
  "name": "flickr.groups.browse",
  "url": "https://www.flickr.com/services/api/flickr.groups.browse.html"
 },
 "flickr.groups.discuss.replies.add": {
  "required": [
   {
    "name": "topic_id",
    "_content": "The ID of the topic to post a comment to."
   },
   {
    "name": "message",
    "_content": "The message to post to the topic."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Topic not found",
    "_content": "The topic_id is invalid."
   },
   {
    "code": "2",
    "message": "Cannot post to group",
    "_content": "Either this account is not a member of the group, or discussion in this group is disabled.\r\n"
   },
   {
    "code": "3",
    "message": "Missing required arguments",
    "_content": "The topic_id and message are required."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.groups.discuss.replies.add",
  "url": "https://www.flickr.com/services/api/flickr.groups.discuss.replies.add.html"
 },
 "flickr.groups.discuss.replies.delete": {
  "required": [
   {
    "name": "topic_id",
    "_content": "The ID of the topic the post is in."
   },
   {
    "name": "reply_id",
    "_content": "The ID of the reply to delete."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Topic not found",
    "_content": "The topic_id is invalid."
   },
   {
    "code": "2",
    "message": "Reply not found",
    "_content": "The reply_id is invalid."
   },
   {
    "code": "3",
    "message": "Cannot delete reply",
    "_content": "Replies can only be edited by their owner."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 3
  },
  "name": "flickr.groups.discuss.replies.delete",
  "url": "https://www.flickr.com/services/api/flickr.groups.discuss.replies.delete.html"
 },
 "flickr.groups.discuss.replies.edit": {
  "required": [
   {
    "name": "topic_id",
    "_content": "The ID of the topic the post is in."
   },
   {
    "name": "reply_id",
    "_content": "The ID of the reply post to edit."
   },
   {
    "name": "message",
    "_content": "The message to edit the post with."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Topic not found",
    "_content": "The topic_id is invalid"
   },
   {
    "code": "2",
    "message": "Reply not found",
    "_content": "The reply_id is invalid."
   },
   {
    "code": "3",
    "message": "Missing required arguments",
    "_content": "The topic_id and reply_id are required."
   },
   {
    "code": "4",
    "message": "Cannot edit reply",
    "_content": "Replies can only be edited by their owner."
   },
   {
    "code": "5",
    "message": "Cannot post to group",
    "_content": "Either this account is not a member of the group, or discussion in this group is disabled."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.groups.discuss.replies.edit",
  "url": "https://www.flickr.com/services/api/flickr.groups.discuss.replies.edit.html"
 },
 "flickr.groups.discuss.replies.getInfo": {
  "required": [
   {
    "name": "topic_id",
    "_content": "The ID of the topic the post is in."
   },
   {
    "name": "reply_id",
    "_content": "The ID of the reply to fetch."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Topic not found",
    "_content": "The topic_id is invalid"
   },
   {
    "code": "2",
    "message": "Reply not found",
    "_content": "The reply_id is invalid"
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.groups.discuss.replies.getInfo",
  "url": "https://www.flickr.com/services/api/flickr.groups.discuss.replies.getInfo.html"
 },
 "flickr.groups.discuss.replies.getList": {
  "required": [
   {
    "name": "topic_id",
    "_content": "The ID of the topic to fetch replies for."
   },
   {
    "name": "per_page",
    "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500."
   }
  ],
  "optional": [
   {
    "name": "page",
    "_content": "The page of results to return. If this argument is omitted, it defaults to 1."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Topic not found",
    "_content": "The topic_id is invalid."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.groups.discuss.replies.getList",
  "url": "https://www.flickr.com/services/api/flickr.groups.discuss.replies.getList.html"
 },
 "flickr.groups.discuss.topics.add": {
  "required": [
   {
    "name": "group_id",
    "_content": "The NSID of the group to add a topic to.\r\n"
   },
   {
    "name": "subject",
    "_content": "The topic subject."
   },
   {
    "name": "message",
    "_content": "The topic message."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Group not found",
    "_content": "The group by that ID does not exist\r\n"
   },
   {
    "code": "2",
    "message": "Cannot post to group",
    "_content": "Either this account is not a member of the group, or discussion in this group is disabled."
   },
   {
    "code": "3",
    "message": "Message is too long",
    "_content": "The post message is too long."
   },
   {
    "code": "4",
    "message": "Missing required arguments",
    "_content": "Subject and message are required."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.groups.discuss.topics.add",
  "url": "https://www.flickr.com/services/api/flickr.groups.discuss.topics.add.html"
 },
 "flickr.groups.discuss.topics.getInfo": {
  "required": [
   {
    "name": "topic_id",
    "_content": "The ID for the topic to edit."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Topic not found",
    "_content": "The topic_id is invalid"
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.groups.discuss.topics.getInfo",
  "url": "https://www.flickr.com/services/api/flickr.groups.discuss.topics.getInfo.html"
 },
 "flickr.groups.discuss.topics.getList": {
  "required": [
   {
    "name": "group_id",
    "_content": "The NSID of the group to fetch information for."
   }
  ],
  "optional": [
   {
    "name": "per_page",
    "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500."
   },
   {
    "name": "page",
    "_content": "The page of results to return. If this argument is omitted, it defaults to 1."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Group not found",
    "_content": "The group_id is invalid"
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.groups.discuss.topics.getList",
  "url": "https://www.flickr.com/services/api/flickr.groups.discuss.topics.getList.html"
 },
 "flickr.groups.getInfo": {
  "required": [
   {
    "name": "group_id",
    "_content": "The NSID of the group to fetch information for."
   }
  ],
  "optional": [
   {
    "name": "lang",
    "_content": "The language of the group name and description to fetch.  If the language is not found, the primary language of the group will be returned.\r\n\r\nValid values are the same as <a href=\"/services/feeds/\">in feeds</a>."
   },
   {
    "name": "secure_image_embeds",
    "_content": "This argument will secure the external image embeds in all the markup and return a secure<Field> back in addition to the <Field>"
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Group not found",
    "_content": "The group NSID passed did not refer to a group that the calling user can see - either an invalid group is or a group that can't be seen by the calling user."
   }
  ],
  "security": {
   "needslogin": 0,
   "needssigning": 0,
   "requiredperms": 0
  },
  "name": "flickr.groups.getInfo",
  "url": "https://www.flickr.com/services/api/flickr.groups.getInfo.html"
 },
 "flickr.groups.join": {
  "required": [
   {
    "name": "group_id",
    "_content": "The NSID of the Group in question"
   }
  ],
  "optional": [
   {
    "name": "accept_rules",
    "_content": "If the group has rules, they must be displayed to the user prior to joining. Passing a true value for this argument specifies that the application has displayed the group rules to the user, and that the user has agreed to them. (See flickr.groups.getInfo)."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Required arguments missing",
    "_content": "The group_id doesn't exist"
   },
   {
    "code": "2",
    "message": "Group does not exist",
    "_content": "The Group does not exist"
   },
   {
    "code": "3",
    "message": "Group not availabie to the account",
    "_content": "The authed account does not have permission to view/join the group."
   },
   {
    "code": "4",
    "message": "Account is already in that group",
    "_content": "The authed account has previously joined this group"
   },
   {
    "code": "5",
    "message": "Membership in group is by invitation only.",
    "_content": "Use flickr.groups.joinRequest to contact the administrations for an invitation."
   },
   {
    "code": "6",
    "message": "User must accept the group rules before joining",
    "_content": "The user must read and accept the rules before joining. Please see the accept_rules argument for this method."
   },
   {
    "code": "10",
    "message": "Account in maximum number of groups",
    "_content": "The account is a member of the maximum number of groups."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.groups.join",
  "url": "https://www.flickr.com/services/api/flickr.groups.join.html"
 },
 "flickr.groups.joinRequest": {
  "required": [
   {
    "name": "group_id",
    "_content": "The NSID of the group to request joining."
   },
   {
    "name": "message",
    "_content": "Message to the administrators."
   },
   {
    "name": "accept_rules",
    "_content": "If the group has rules, they must be displayed to the user prior to joining. Passing a true value for this argument specifies that the application has displayed the group rules to the user, and that the user has agreed to them. (See flickr.groups.getInfo)."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Required arguments missing",
    "_content": "The group_id or message argument are missing."
   },
   {
    "code": "2",
    "message": "Group does not exist",
    "_content": "The Group does not exist"
   },
   {
    "code": "3",
    "message": "Group not available to the account",
    "_content": "The authed account does not have permission to view/join the group."
   },
   {
    "code": "4",
    "message": "Account is already in that group",
    "_content": "The authed account has previously joined this group"
   },
   {
    "code": "5",
    "message": "Group is public and open",
    "_content": "The group does not require an invitation to join, please use flickr.groups.join."
   },
   {
    "code": "6",
    "message": "User must accept the group rules before joining",
    "_content": "The user must read and accept the rules before joining. Please see the accept_rules argument for this method."
   },
   {
    "code": "7",
    "message": "User has already requested to join that group",
    "_content": "A request has already been sent and is pending approval."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.groups.joinRequest",
  "url": "https://www.flickr.com/services/api/flickr.groups.joinRequest.html"
 },
 "flickr.groups.leave": {
  "required": [
   {
    "name": "group_id",
    "_content": "The NSID of the Group to leave"
   }
  ],
  "optional": [
   {
    "name": "delete_photos",
    "_content": "Delete all photos by this user from the group"
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Required arguments missing",
    "_content": "The group_id doesn't exist"
   },
   {
    "code": "2",
    "message": "Group does not exist",
    "_content": "The group by that ID does not exist"
   },
   {
    "code": "3",
    "message": "Account is not in that group",
    "_content": "The user is not a member of the group that was specified"
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 3
  },
  "name": "flickr.groups.leave",
  "url": "https://www.flickr.com/services/api/flickr.groups.leave.html"
 },
 "flickr.groups.members.getList": {
  "required": [
   {
    "name": "group_id",
    "_content": "Return a list of members for this group.  The group must be viewable by the Flickr member on whose behalf the API call is made."
   }
  ],
  "optional": [
   {
    "name": "membertypes",
    "_content": "Comma separated list of member types\r\n<ul>\r\n<li>2: member</li>\r\n<li>3: moderator</li>\r\n<li>4: admin</li>\r\n</ul>\r\nBy default returns all types.  (Returning super rare member type \"1: narwhal\" isn't supported by this API method)"
   },
   {
    "name": "per_page",
    "_content": "Number of members to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500."
   },
   {
    "name": "page",
    "_content": "The page of results to return. If this argument is omitted, it defaults to 1."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Group not found",
    "_content": ""
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 1
  },
  "name": "flickr.groups.members.getList",
  "url": "https://www.flickr.com/services/api/flickr.groups.members.getList.html"
 },
 "flickr.groups.pools.add": {
  "required": [
   {
    "name": "photo_id",
    "_content": "The id of the photo to add to the group pool. The photo must belong to the calling user."
   },
   {
    "name": "group_id",
    "_content": "The NSID of the group who's pool the photo is to be added to."
   }
  ],
  "errors": [
   {
    "code": "1",
    "message": "Photo not found",
    "_content": "The photo id passed was not the id of a photo owned by the caling user."
   },
   {
    "code": "2",
    "message": "Group not found",
    "_content": "The group id passed was not a valid id for a group the user is a member of."
   },
   {
    "code": "3",
    "message": "Photo already in pool",
    "_content": "The specified photo is already in the pool for the specified group."
   },
   {
    "code": "4",
    "message": "Photo in maximum number of pools",
    "_content": "The photo has already been added to the maximum allowed number of pools."
   },
   {
    "code": "5",
    "message": "Photo limit reached",
    "_content": "The user has already added the maximum amount of allowed photos to the pool."
   },
   {
    "code": "6",
    "message": "Your Photo has been added to the Pending Queue for this Pool",
    "_content": "The pool is moderated, and the photo has been added to the Pending Queue. If it is approved by a group administrator, it will be added to the pool."
   },
   {
    "code": "7",
    "message": "Your Photo has already been added to the Pending Queue for this Pool",
    "_content": "The pool is moderated, and the photo has already been added to the Pending Queue."
   },
   {
    "code": "8",
    "message": "Content not allowed",
    "_content": "The content has been disallowed from the pool by the group admin(s)."
   },
   {
    "code": "10",
    "message": "Maximum number of photos in Group Pool",
    "_content": "A group pool has reached the upper limit for the number of photos allowed."
   }
  ],
  "security": {
   "needslogin": 1,
   "needssigning": 1,
   "requiredperms": 2
  },
  "name": "flickr.groups.pools.add",
  "url": "https://www.flickr.com/services/api/flickr.groups.pools.add.html"
 },
 "flickr.groups.pools.getContext": {
  "required": [
   {
    "name": "photo_id",
    "_content": "The id of the photo to fetch the context for."
   },
   {
    "name": "group_id",
    "_content": "The nsid of the group who's pool to fetch the photo's context for."
   }
  ],
  "optional": [
   {
    "name": "num_prev",
    "_content": ""
   },
   {
    "name": "num_next",
    "_content": ""
   },
   {
    "name": "extras",
    "_content": "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_for…

Large files files are truncated, but you can click here to view the full file