flickrex

{
  "arguments": {
    "argument": [
      {
        "_content": "Your API application key. <a href=\"/services/api/misc.api_keys.html\">See here</a> for more details.",
        "name": "api_key",
        "optional": 0
      },
      {
        "_content": "The id of the photo to set permissions for.",
        "name": "photo_id",
        "optional": "0"
      },
      {
        "_content": "1 to set the photo to public, 0 to set it to private.",
        "name": "is_public",
        "optional": "0"
      },
      {
        "_content": "1 to make the photo visible to friends when private, 0 to not.",
        "name": "is_friend",
        "optional": "0"
      },
      {
        "_content": "1 to make the photo visible to family when private, 0 to not.",
        "name": "is_family",
        "optional": "0"
      },
      {
        "_content": "who can add comments to the photo and it's notes. one of:<br />\n<code>0</code>: nobody<br />\n<code>1</code>: friends &amp; family<br />\n<code>2</code>: contacts<br />\n<code>3</code>: everybody",
        "name": "perm_comment",
        "optional": "1"
      },
      {
        "_content": "who can add notes and tags to the photo. one of:<br />\n<code>0</code>: nobody / just the owner<br />\n<code>1</code>: friends &amp; family<br />\n<code>2</code>: contacts<br />\n<code>3</code>: everybody\n",
        "name": "perm_addmeta",
        "optional": "1"
      }
    ]
  },
  "errors": {
    "error": [
      {
        "_content": "The photo id passed was not a valid photo id of a photo belonging to the calling user.",
        "code": "1",
        "message": "Photo not found"
      },
      {
        "_content": "Some or all of the required arguments were not supplied.",
        "code": "2",
        "message": "Required arguments missing"
      },
      {
        "_content": "SSL is required to access the Flickr API.",
        "code": 95,
        "message": "SSL is required"
      },
      {
        "_content": "The passed signature was invalid.",
        "code": 96,
        "message": "Invalid signature"
      },
      {
        "_content": "The call required signing but no signature was sent.",
        "code": 97,
        "message": "Missing signature"
      },
      {
        "_content": "The login details or auth token passed were invalid.",
        "code": 98,
        "message": "Login failed / Invalid auth token"
      },
      {
        "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.",
        "code": 99,
        "message": "User not logged in / Insufficient permissions"
      },
      {
        "_content": "The API key passed was not valid or has expired.",
        "code": 100,
        "message": "Invalid API Key"
      },
      {
        "_content": "The requested service is temporarily unavailable.",
        "code": 105,
        "message": "Service currently unavailable"
      },
      {
        "_content": "The requested operation failed due to a temporary issue.",
        "code": 106,
        "message": "Write operation failed"
      },
      {
        "_content": "The requested response format was not found.",
        "code": 111,
        "message": "Format \"xxx\" not found"
      },
      {
        "_content": "The requested method was not found.",
        "code": 112,
        "message": "Method \"xxx\" not found"
      },
      {
        "_content": "The SOAP envelope send in the request could not be parsed.",
        "code": 114,
        "message": "Invalid SOAP envelope"
      },
      {
        "_content": "The XML-RPC request document could not be parsed.",
        "code": 115,
        "message": "Invalid XML-RPC Method Call"
      },
      {
        "_content": "One or more arguments contained a URL that has been used for abuse on Flickr.",
        "code": 116,
        "message": "Bad URL found"
      }
    ]
  },
  "method": {
    "description": {
      "_content": "Set permissions for a photo."
    },
    "name": "flickr.photos.setPerms",
    "needslogin": 1,
    "needssigning": 1,
    "requiredperms": "2",
    "response": {
      "_content": "<photoid secret=\"abcdef\" originalsecret=\"abcdef\">1234</photoid>"
    }
  },
  "stat": "ok"
}