Specs

add_comment(arg(), arg(), opts()) :: operation()

Add comment to a photo as the currently authenticated user.

This method requires authentication with "write" permission.

Arguments

• photo_id - The id of the photo to add a comment to.

• comment_text - Text of the comment

Example response

%{
  "comment" => %{"id" => "97777-72057594037941949-72057594037942602"},
  "stat" => "ok"
}

Specs

delete_comment(arg(), opts()) :: operation()

Delete a comment as the currently authenticated user.

This method requires authentication with "write" permission.

Arguments

• comment_id - The id of the comment to edit.

Specs

edit_comment(arg(), arg(), opts()) :: operation()

Edit the text of a comment as the currently authenticated user.

This method requires authentication with "write" permission.

Arguments

• comment_id - The id of the comment to edit.

• comment_text - Update the comment to this text.

Specs

get_list(arg(), opts()) :: operation()

Returns the comments for a photo

This method does not require authentication.

Arguments

• photo_id - The id of the photo to fetch comments for.

Options

• min_comment_date - Minimum date that a a comment was added. The date should be in the form of a unix timestamp.

• max_comment_date - Maximum date that a comment was added. The date should be in the form of a unix timestamp.

Example response

%{
  "comments" => %{
    "comment" => %{
      "_content" => "Umm, I'm not sure, can I get back to you on that one?",
      "author" => "35468159852@N01",
      "authorname" => "Rev Dan Catt",
      "datecreate" => "1141841470",
      "id" => "6065-109722179-72057594077818641",
      "permalink" => "http://www.flickr.com/photos/straup/109722179/#comment72057594077818641"
    },
    "photo_id" => "109722179"
  },
  "stat" => "ok"
}

Specs

get_recent_for_contacts(opts()) :: operation()

Return the list of photos belonging to your contacts that have been commented on recently.

This method requires authentication with "read" permission.

Options

• date_lastcomment - Limits the resultset to photos that have been commented on since this date. The date should be in the form of a Unix timestamp.<br /><br /> The default, and maximum, offset is (1) hour.

• contacts_filter - A comma-separated list of contact NSIDs to limit the scope of the query to.

• extras - A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_q</code>, <code>url_m</code>, <code>url_n</code>, <code>url_z</code>, <code>url_c</code>, <code>url_l</code>, <code>url_o</code>

• 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.