class Disqussion::Users
Public Instance Methods
Updates username for the user, fails if username does not meet requirements, or is taken by another user @accessibility: public key, secret key @methods: POST @format: json, jsonp @authenticated: true @limited: false @param username [String] A Disqus username. Defaults to null. Minimum length of 3 and Maximum length of 30 @example Updates username for the user for ‘the88’ to ‘saxonbeat’
Disqussion::Client.users.checkusername(:username => 'saxonbeat')
@see: disqus.com/api/3.0/users/checkUsername.json
# File lib/disqussion/client/users.rb, line 13 def checkUsername(*args) options = args.last.is_a?(Hash) ? args.pop : {} options[:username] = args.first response = post('users/checkUsername', options) end
Returns details of a user @accessibility: public key, secret key @methods: GET @format: json, jsonp @authenticated: false @limited: false @param user [Integer, String] A Disqus user ID or screen name. @return [Hashie::Rash] Details on the requested user. @example Return extended information for ‘the88’
Disqussion::Client.user("the88") Disqussion::Client.user(1234) # Same as above
@see: disqus.com/api/3.0/users/details.json
# File lib/disqussion/client/users.rb, line 32 def details(*args) options = args.last.is_a?(Hash) ? args.pop : {} user = args.first merge_user_into_options!(user, options) response = get('users/details', options) end
Follow a user @accessibility: public key, secret key @methods: POST @format: json, jsonp @authenticated: true @limited: false @param target [Integer, String] A Disqus user ID or screen name. @return [Hashie::Rash] Details on the requested user. @example Return extended information for ‘the88’
Disqussion::Client.follow("the88") Disqussion::Client.follow(1234) # Same as above
@see: disqus.com/api/3.0/users/details.json
# File lib/disqussion/client/users.rb, line 51 def follow(*args) options = args.last.is_a?(Hash) ? args.pop : {} target = args.first merge_target_into_options!(target, options) response = post('users/follow', options) end
Returns a list of forums a user has been active on. @accessibility: public key, secret key @methods: GET @format: json, jsonp @authenticated: false @limited: false @return [Hashie::Rash] Details on the list of posts. @param options [Hash] A customizable set of options. @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null @option options [Integer] :cursor. Defaults to null @option options [Integer] :limit. Defaults to 25. Maximum length of 100 @option options [Integer] :user. Defaults to null. Looks up a user by ID. You may look up a user by username using the ‘username’ query type. @option options [String] :order. Defaults to “desc”. Choices: asc, desc @example Return a list of forums user 1234 has been active on
Disqussion::Client.users.listActiveForums(:user => 1234)
@see: disqus.com/api/3.0/users/listActiveForums.json
# File lib/disqussion/client/users.rb, line 74 def listActiveForums(*args) options = args.last.is_a?(Hash) ? args.pop : {} response = get('users/listActiveForums', options) end
BETA Returns a list of threads a user has participated in sorted by last activity. @accessibility: public key, secret key @methods: GET @format: json, jsonp @authenticated: false @limited: true @return [Hashie::Rash] Details on the list of active threads. @param options [Hash] A customizable set of options. @option options [String] :forum. Looks up a forum by ID (aka short name). Defaults to null @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null @option options [Integer, String] :related. Allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum, author and category. @option options [Integer] :cursor. Defaults to null @option options [Integer] :limit. Defaults to 25. Maximum length of 100 @option options [Integer] :user. Defaults to null. Looks up a user by ID. You may look up a user by username using the ‘username’ query type. @option options [String, Array] :include. Allows multiple. Defaults to [“open”, “closed” ]. Choices: open, closed, killedr @option options [String] :order. Defaults to “desc”. Choices: asc, desc @example Return a list of active threads user 1234 has been active on
Disqussion::Client.users.listActiveThreadss(:user => 1234)
@see: disqus.com/api/3.0/users/listActiveThreads.json
# File lib/disqussion/client/users.rb, line 99 def listActiveThreads(*args) options = args.last.is_a?(Hash) ? args.pop : {} response = get('users/listActiveThreads', options) end
BETA Returns a list of various activity types made by the user. @accessibility: public key, secret key @methods: GET @format: json, jsonp @authenticated: false @limited: true @return [Hashie::Rash] Details on the list of active threads. @param options [Hash] A customizable set of options. @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null @option options [Integer, String] :related. Allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum, author and category. @option options [Integer] :cursor. Defaults to null @option options [Integer] :limit. Defaults to 25. Maximum length of 100 @option options [Integer] :user. Defaults to null. Looks up a user by ID. You may look up a user by username using the ‘username’ query type. @option options [String, Array] :include. Allows multiple. Defaults to [“user”, “replies”, “following” ]. Choices: user, replies, following @option options [String] :anon_user. Defaults to null. Looks up an anonymous user by unique hash. @example Return a list of active threads user 1234 has been active on
Disqussion::Client.users.listActivity(:user => 1234)
@see: disqus.com/api/3.0/users/listActivity.json
# File lib/disqussion/client/users.rb, line 123 def listActivity(*args) options = args.last.is_a?(Hash) ? args.pop : {} response = get('users/listActivity', options) end
BETA Returns a list of users a user is being followed by. @accessibility: public key, secret key @methods: GET @format: json, jsonp @authenticated: false @limited: true @return [Hashie::Rash] Details on the users the user is being followed by. @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null @option options [Integer] :cursor. Defaults to null @option options [Integer] :limit. Defaults to 25. Maximum length of 100 @option options [Integer] :user. Defaults to null. Looks up a user by ID. You may look up a user by username using the ‘username’ query type. @option options [String] :order. Defaults to “asc”. Choices: asc, desc @example Return a list of users the user is currently being followed by
Disqussion::Client.users.listFollowers(:user => 1234)
@see: disqus.com/api/3.0/users/listFollowers.json
# File lib/disqussion/client/users.rb, line 144 def listFollowers(*args) options = args.last.is_a?(Hash) ? args.pop : {} response = get('users/listFollowers', options) end
BETA Returns a list of users a user is following. @accessibility: public key, secret key @methods: GET @format: json, jsonp @authenticated: false @limited: true @return [Hashie::Rash] Details on the users the user is following. @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null @option options [Integer] :cursor. Defaults to null @option options [Integer] :limit. Defaults to 25. Maximum length of 100 @option options [Integer] :user. Defaults to null. Looks up a user by ID. You may look up a user by username using the ‘username’ query type. @option options [String] :order. Defaults to “asc”. Choices: asc, desc @example Return a list of users the user is currently following
Disqussion::Client.users.listFollowing(:user => 1234)
@see: disqus.com/api/3.0/users/listFollowing.json
# File lib/disqussion/client/users.rb, line 165 def listFollowing(*args) options = args.last.is_a?(Hash) ? args.pop : {} response = get('users/listFollowing', options) end
Returns a list of forums a user owns. @accessibility: public key, secret key @methods: GET @format: json, jsonp @authenticated: false @limited: false @return [Hashie::Rash] Details on the list of forums. @param options [Hash] A customizable set of options. @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null @option options [Integer] :cursor. Defaults to null @option options [Integer] :limit. Defaults to 25. Maximum length of 100 @option options [Integer] :user. Defaults to null. Looks up a user by ID. You may look up a user by username using the ‘username’ query type. @option options [String] :order. Defaults to “desc”. Choices: asc, desc @example Return a list of forums owned by user 1234
Disqussion::Client.users.listForums(:user => 1234)
@see: disqus.com/api/3.0/users/listForums.json
# File lib/disqussion/client/users.rb, line 186 def listForums(*args) options = args.last.is_a?(Hash) ? args.pop : {} response = get('users/listForums', options) end
BETA Returns a list of forums a user has been active on recenty, sorted by the user’s activity. @accessibility: public key, secret key @methods: GET @format: json, jsonp @authenticated: false @limited: true @return [Hashie::Rash] Details on the users list of forums they have been most active on recently. @option options [Integer] :limit. Defaults to 25. Maximum length of 100 @option options [Integer] :user. Defaults to null. Looks up a user by ID. You may look up a user by username using the ‘username’ query type. @example Return a list of the forums the user has been most active on recently.
Disqussion::Client.users.listMostActiveForums(:user => 1234)
@see: disqus.com/api/3.0/users/listMostActiveForums.json
# File lib/disqussion/client/users.rb, line 204 def listMostActiveForums(*args) options = args.last.is_a?(Hash) ? args.pop : {} response = get('users/listMostActiveForums', options) end
Returns a list of posts made by the user. @accessibility: public key, secret key @methods: GET @format: json, jsonp @authenticated: false @limited: false @return [Hashie::Rash] Details on the list of forums. @param options [Hash] A customizable set of options. @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null @option options [Integer, String] :related. Allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum, thread. @option options [Integer] :cursor. Defaults to null @option options [Integer] :limit. Defaults to 25. Maximum length of 100 @option options [Integer] :user. Defaults to null. Looks up a user by ID. You may look up a user by username using the ‘username’ query type. @option options [String, Array] :include. Allows multiple. Defaults to [“approved”]. Choices: unapproved, approved, spam, deleted, flagged, highlighted @option options [String] :order. Defaults to “desc”. Choices: asc, desc @example Return a list of user 1234s posts
Disqussion::Client.users.listPosts(:user => 1234)
@see: disqus.com/api/3.0/users/listPosts.json
# File lib/disqussion/client/users.rb, line 227 def listPosts(*args) options = args.last.is_a?(Hash) ? args.pop : {} response = get('users/listPosts', options) end
Unfollow a user @accessibility: public key, secret key @methods: GET @format: json, jsonp @authenticated: true @limited: false @param user [Integer, String] A Disqus user ID or screen name. @return [Hashie::Rash] Details on the requested user. @example Return extended information for ‘the88’
Disqussion::Client.unfollow("the88") Disqussion::Client.unfollow(1234) # Same as above
@see: disqus.com/api/3.0/users/details.json
# File lib/disqussion/client/users.rb, line 244 def unfollow(*args) options = args.last.is_a?(Hash) ? args.pop : {} target = args.first merge_target_into_options!(target, options) response = post('users/unfollow', options) end