Flickrex.Flickr.Groups.Discuss.Topics (flickrex v0.8.1) View Source

Link to this section Summary

Functions

Post a new discussion topic to a group.

Get information about a group discussion topic.

Get a list of discussion topics in a group.

Link to this section Types

Link to this section Functions

Link to this function

add(group_id, subject, message, opts \\ [])

View Source

Specs

add(arg(), arg(), arg(), opts()) :: operation()

Post a new discussion topic to a group.

This method requires authentication with "write" permission.

Arguments

  • group_id - The NSID or path alias of the group to add a topic to.

  • subject - The topic subject.

  • message - The topic message.

Link to this function

get_info(group_id, topic_id, opts \\ [])

View Source

Specs

get_info(arg(), arg(), opts()) :: operation()

Get information about a group discussion topic.

This method does not require authentication.

Arguments

  • group_id - NSID or group alias of the group to which the topic belongs. Making this parameter optional for legacy reasons, but it is highly recommended to pass this in to get better performance.

  • topic_id - The ID for the topic to edit.

Example response

%{
  "stat" => "ok",
  "topic" => %{
    "author" => "30134652@N05",
    "authorname" => "JAMAL'S ACCOUNT",
    "can_delete" => "0",
    "can_edit" => "1",
    "can_reply" => "0",
    "count_replies" => "1",
    "datecreate" => "1337975869",
    "datelastpost" => "1337975921",
    "iconfarm" => "0",
    "iconserver" => "0",
    "id" => "72157607082559966",
    "is_locked" => "0",
    "is_pro" => "0",
    "is_sticky" => "0",
    "last_reply" => "72157607082559968",
    "message" => %{"_content" => "Is anyone still around in this group?"},
    "role" => "admin",
    "subject" => "Who's still around?"
  }
}
Link to this function

get_list(group_id, opts \\ [])

View Source

Specs

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

Get a list of discussion topics in a group.

This method does not require authentication.

Arguments

  • group_id - The NSID or path alias of the group to fetch information for.

Options

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

Example response

%{
  "stat" => "ok",
  "topics" => %{
    "group_id" => "46744914@N00",
    "iconfarm" => "1",
    "iconserver" => "1",
    "ispoolmoderated" => "1",
    "lang" => "en-us",
    "members" => "12428",
    "name" => "Tell a story in 5 frames (Visual story telling)",
    "page" => "1",
    "pages" => "2310",
    "per_page" => "2",
    "privacy" => "3",
    "topic" => [
      %{
        "author" => "53930889@N04",
        "authorname" => "Smallportfolio_jm08",
        "can_delete" => "0",
        "can_edit" => "0",
        "can_reply" => "0",
        "count_replies" => "8",
        "datecreate" => "1287070965",
        "datelastpost" => "1336905518",
        "iconfarm" => "6",
        "iconserver" => "5169",
        "id" => "72157625038324579",
        "is_locked" => "",
        "is_sticky" => "0",
        "message" => %{
          "_content" => "<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5080874079/" title="Star Wars 1 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4035/5080874079_684cf874e0_m.jpg" width="240" height="180" alt="Star Wars 1 by Smallportfolio_jm08"  class="pc_img" border="0" /></a></span></div>\n\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467846/" title="Star Wars 2 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4071/5081467846_2eec86176d_m.jpg" width="240" height="180" alt="Star Wars 2 by Smallportfolio_jm08"  class="pc_img" border="0" /></a></span></div>\n\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467886/" title="Star Wars 3 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4021/5081467886_d8cca6c8e8_m.jpg" width="240" height="180" alt="Star Wars 3 by Smallportfolio_jm08"  class="pc_img" border="0" /></a></span></div>\n\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467910/" title="Star Wars 4 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4084/5081467910_274bb11fdc_m.jpg" width="240" height="180" alt="Star Wars 4 by Smallportfolio_jm08"  class="pc_img" border="0" /></a></span></div>\n\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467948/" title="Star Wars 5 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4154/5081467948_1a5f200bc0_m.jpg" width="240" height="180" alt="Star Wars 5 by Smallportfolio_jm08"  class="pc_img" border="0" /></a></span></div>"
        },
        "role" => "member",
        "subject" => "A long time ago in a galaxy far, far away..."
      },
      %{
        "author" => "75240402@N04",
        "authorname" => "Nokinrocks",
        "can_delete" => "0",
        "can_edit" => "0",
        "can_reply" => "0",
        "count_replies" => "0",
        "datecreate" => "1336485653",
        "datelastpost" => "1336485653",
        "iconfarm" => "8",
        "iconserver" => "7027",
        "id" => "72157629635119774",
        "is_locked" => "",
        "is_sticky" => "0",
        "message" => %{
          "_content" => "<a href="http://www.flickr.com/photos/nokinrocks/7120495637/"><img class="notsowide" src="http://farm9.staticflickr.com/8005/7120495637_fec0382b4b_n.jpg" width="320" height="256" alt="Step It Up" /></a>\n\n<a href="http://www.flickr.com/photos/nokinrocks/7122908705/"><img class="notsowide" src="http://farm8.staticflickr.com/7259/7122908705_3bef338378_n.jpg" width="240" height="320" alt="P1050351" /></a>\n\n<a href="http://www.flickr.com/photos/nokinrocks/7122922123/"><img class="notsowide" src="http://farm8.staticflickr.com/7052/7122922123_2bfcb6707c_n.jpg" width="214" height="320" alt="Frog On A Log" /></a>\n\n<a href="http://www.flickr.com/photos/nokinrocks/7122929521/"><img class="notsowide" src="http://farm8.staticflickr.com/7047/7122929521_8ffebdd424_n.jpg" width="320" height="200" alt="P1050397" /></a>\n\n<a href="http://www.flickr.com/photos/nokinrocks/7122916999/"><img class="notsowide" src="http://farm8.staticflickr.com/7200/7122916999_a7328f9dcc_n.jpg" width="320" height="261" alt="P1050361" /></a>"
        },
        "role" => "member",
        "subject" => "Where The Fish Are"
      }
    ],
    "total" => "4621"
  }
}