RHP_API

<back to all web services

GetUserSettings

Get the current user's system settings.

Requires Authentication
The following routes are available for this service:
GET/User/Account/Settings
UserAccountSettings Parameters:
NameParameterData TypeRequiredDescription
ToolTipsformList<ToolTip>NoList of all viewed ToolTips
ClientformClientSettingsNoClient settings
ProfileformProfileDetailSettingsNoUser Profile details
MessengerformMessengerSettingsNoMessenger Settings
ChatroomSettingsformChatroomSettingsNoChatrooms Settings
AccountSettingsformAccountSettingsNoAccount Settings
PushSettingsformPushSettingsNoPush Settings
LinkedAccountsformLinkedUserAccountsNoLinked Accounts
StreamSettingsformStreamSettingsNoHome Stream settings
ToolTip Parameters:
NameParameterData TypeRequiredDescription
ViewCountformintNoThe number of times that a tooltip has been viewed.
ToolTipTypeformToolTipTypeNoTooltip type data.
ToolTipType Parameters:
NameParameterData TypeRequiredDescription
IDformintNoToolTipType ID
DisplayLimitformshortNoMaximum number of times a user can view a ToolTip
NameformstringNoToolTip name
ClientSettings Parameters:
NameParameterData TypeRequiredDescription
IsSpotlightFeaturedEnabledformboolNoDetermines if the user has the Spotlight popup enabled.
SafeModeformboolNoDetermines if the user has SafeMode enabled.
FileUploadLimitformintNoThe maximum file upload size supported.
IsImageReplyEnabledformboolNoIf true allow reply with Gif or Image in all comments (and comment replies), as well as allow Gifs in Messenger.
GrantsformClientGrantsNoClient features settings
IsIgnoreConversationEnabledformboolNoIf true the ignore confersation feature is active.
IsGiftingEnabledformboolNoIf true the Store Credit / Gifting feature is active.
IsUserPhotoCommentsEnabledformboolNoIf true show the comment button on user photos.
UserVideoSizeLimitformintNoThe maximum user video upload size supported (bytes).
CommunityVideoSizeLimitformintNoThe maximum community video upload size supported (bytes).
IsVideoMessageEnabledformboolNoIf true the Video messaging is active.
MobileValidationNumberformstringNoMobile number for manual validation.
UserVideoUploadMaxRetriesformintNoThe number of times to poll when merging a Video.
UserVideoUploadPollIntervalformintNoThe number milliseconds between polls when merging a Video.
ClientGrants Parameters:
NameParameterData TypeRequiredDescription
ProspectsformProspectGrantsNo
PhotoformPhotoGrantsNo
MessageformMessageGrantsNo
EventformEventGrantsNo
GroupformGroupGrantsNo
ProfileformPofileGrantsNo
CommunityformCommunityGrantsNo
ProspectGrants Parameters:
NameParameterData TypeRequiredDescription
CanViewLikesformboolNo
CanViewMatchesformboolNo
CanRemoveLikeformboolNo
CanRemoveFavformboolNo
PhotoGrants Parameters:
NameParameterData TypeRequiredDescription
UploadRequiredformboolNo
MessageGrants Parameters:
NameParameterData TypeRequiredDescription
AUVisaRequiredformboolNo
ShowReplyLimitformboolNo
CanMakeVideoCallsformboolNo
EventGrants Parameters:
NameParameterData TypeRequiredDescription
CanViewContactsformboolNo
CanCreateEventformboolNo
GroupGrants Parameters:
NameParameterData TypeRequiredDescription
CanManageGroupsformboolNo
PofileGrants Parameters:
NameParameterData TypeRequiredDescription
CanViewPhoneNumbersformboolNo
CanUseAnonymousBrowsingformboolNo
CommunityGrants Parameters:
NameParameterData TypeRequiredDescription
ArticleCanCommentformboolNo
EventCanCommentformboolNo
StoryCanCommentformboolNo
ForumCanCommentformboolNo
ProfileDetailSettings Parameters:
NameParameterData TypeRequiredDescription
CountryformCountryNo
Country Parameters:
NameParameterData TypeRequiredDescription
CountryIDformintNo
NameformstringNo
CodeformstringNo
ShowformboolNo
MapzenLabelformstringNo
GoogleMapPlacesIdformstringNo
LatitudeformdoubleNo
LongitudeformdoubleNo
MessengerSettings Parameters:
NameParameterData TypeRequiredDescription
PermissionMessageReceiveformMessageReceivePermissionNoDetermines if a user can receive a message.
PermissionVideoCallformMessageReceivePermissionNoDetermines if a user can receive a video call.
ReplyLimitDaysformintNoThe number of days that a user can reply after the last received message in a conversation, if less than one is returned there is no limit.
DefaultFolderformMessageFoldersNo
OperationMethodformstringNo
DefaultImageDurationformMessageImageDurationNoDefault image shared duration.
CanReceivePhotosformboolNo
CanReceiveGiftsformboolNo
IsActiveformbool?NoIf true the client should display the 'Service Unavailable' popup.
ThemeformMessengerThemeNo
MessengerTheme Parameters:
NameParameterData TypeRequiredDescription
DarkModeformboolNoDEPRECATED. Replaced with DarkModeSetting
DarkModeSettingformToggleWithDefaultNo
ThemeTypeformMessengerThemeTypeNo
FontSizeformMessengerFontSizeNo
ChatroomSettings Parameters:
NameParameterData TypeRequiredDescription
PermissionMessageReceiveformChatroomMessageReceivePermissionNoDetermine's who the user can receive message from.
IsSoundEnabledformboolNoDetermine's if the user wants the sounds to play.
IsActiveformboolNoIf true the client should display the 'Service Unavailable' popup.
AccountSettings Parameters:
NameParameterData TypeRequiredDescription
ProfileViewableformboolNo
ShowOnlineformboolNo
AnonymousBrowsingformboolNo
ReceiveEmailMessagesformboolNoThis parameter is deprecated, use email settings
AccountStatusformAccountStatusNoAccountStatus indicates the status of a user account
AccountPausedformboolNoThis parameter is deprecated, use AccountStatus
AccountRequiresAuthenticationformboolNoThis parameter is deprecated, use AccountStatus
EmailNotificationSettingsformEmailNotificationSettingsNo
NewPasswordRequiredformboolNo
FeatureProfileformboolNo
PromoteProfileformboolNo
ProfileBoostExpiryformDateTime?No
ProfileViewSettingsformProfileViewSettingsNo
ShareProfileCodeformstringNo
ValidationViewSettingformProfileViewSettingsNo
IntimateInfoViewSettingsformProfileViewSettingsNo
ProfileActivityViewSettingsformProfileViewSettingsNo
AccountDeletedDateformDateTime?No
GCLIDformstringNo
EmailNotificationSettings Parameters:
NameParameterData TypeRequiredDescription
MatchReportformboolNo
DateFinderformboolNo
EventsformboolNo
OffersformboolNo
RHPTeamMessagesformboolNo
PushSettings Parameters:
NameParameterData TypeRequiredDescription
IsEnabledformboolNoThis parameter is deprecated
PushTokenformstringNo
NotificationSettingsformPushNotificationSettingsNo
PushNotificationSettings Parameters:
NameParameterData TypeRequiredDescription
MessagesformMessageReceivePermissionNo
ViewsformMessageReceivePermissionNo
LikesformMessageReceivePermissionNo
FavouritesformMessageReceivePermissionNo
GroupChatformGroupChatPushNotificationPermissionNo
MatchesformboolNo
RHPTeamMessagesformboolNo
PushTagsformstringNo
DateFinderInterestformboolNo
ForumCommentformboolNo
StoryCommentformboolNo
EventCommentformboolNo
LinkedUserAccounts Parameters:
NameParameterData TypeRequiredDescription
FacebookformboolNo
AppleformboolNo
GoogleformboolNo
StreamSettings Parameters:
NameParameterData TypeRequiredDescription
ActivityFiltersformUserActivityFilter[]No

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /User/Account/Settings HTTP/1.1 
Host: tstsrvs.redhotpie.com.au 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	ToolTips: 
	[
		{
			ViewCount: 0,
			ToolTipType: 
			{
				ID: 0,
				DisplayLimit: 0,
				Name: String
			}
		}
	],
	Client: 
	{
		IsSpotlightFeaturedEnabled: False,
		SafeMode: False,
		FileUploadLimit: 0,
		IsImageReplyEnabled: False,
		Grants: 
		{
			Prospects: 
			{
				CanViewLikes: False,
				CanViewMatches: False,
				CanRemoveLike: False,
				CanRemoveFav: False
			},
			Photo: 
			{
				UploadRequired: False
			},
			Message: 
			{
				AUVisaRequired: False,
				ShowReplyLimit: False,
				CanMakeVideoCalls: False
			},
			Event: 
			{
				CanViewContacts: False,
				CanCreateEvent: False
			},
			Group: 
			{
				CanManageGroups: False
			},
			Profile: 
			{
				CanViewPhoneNumbers: False,
				CanUseAnonymousBrowsing: False
			},
			Community: 
			{
				ArticleCanComment: False,
				EventCanComment: False,
				StoryCanComment: False,
				ForumCanComment: False
			}
		},
		IsIgnoreConversationEnabled: False,
		IsGiftingEnabled: False,
		IsUserPhotoCommentsEnabled: False,
		UserVideoSizeLimit: 0,
		CommunityVideoSizeLimit: 0,
		IsVideoMessageEnabled: False,
		MobileValidationNumber: String,
		UserVideoUploadMaxRetries: 0,
		UserVideoUploadPollInterval: 0
	},
	Profile: 
	{
		Country: 
		{
			CountryID: 0,
			Name: String,
			Code: String,
			Show: False,
			MapzenLabel: String,
			GoogleMapPlacesId: String,
			Latitude: 0,
			Longitude: 0
		}
	},
	Messenger: 
	{
		PermissionMessageReceive: Anyone,
		PermissionVideoCall: Anyone,
		ReplyLimitDays: 0,
		DefaultFolder: All,
		OperationMethod: String,
		DefaultImageDuration: None,
		CanReceivePhotos: False,
		CanReceiveGifts: False,
		IsActive: False,
		Theme: 
		{
			DarkMode: False,
			DarkModeSetting: Default,
			ThemeType: Green,
			FontSize: Small
		}
	},
	ChatroomSettings: 
	{
		PermissionMessageReceive: Anyone,
		IsSoundEnabled: False,
		IsActive: False
	},
	AccountSettings: 
	{
		ProfileViewable: False,
		ShowOnline: False,
		AnonymousBrowsing: False,
		ReceiveEmailMessages: False,
		AccountStatus: Active,
		AccountPaused: False,
		AccountRequiresAuthentication: False,
		EmailNotificationSettings: 
		{
			MatchReport: False,
			DateFinder: False,
			Events: False,
			Offers: False,
			RHPTeamMessages: False
		},
		NewPasswordRequired: False,
		FeatureProfile: False,
		PromoteProfile: False,
		ProfileBoostExpiry: 0001-01-01,
		ProfileViewSettings: Everyone,
		ShareProfileCode: String,
		ValidationViewSetting: Everyone,
		IntimateInfoViewSettings: Everyone,
		ProfileActivityViewSettings: Everyone,
		AccountDeletedDate: 0001-01-01,
		GCLID: String
	},
	PushSettings: 
	{
		IsEnabled: False,
		PushToken: String,
		NotificationSettings: 
		{
			Messages: Anyone,
			Views: Anyone,
			Likes: Anyone,
			Favourites: Anyone,
			GroupChat: Anyone,
			Matches: False,
			RHPTeamMessages: False,
			PushTags: String,
			DateFinderInterest: False,
			ForumComment: False,
			StoryComment: False,
			EventComment: False
		}
	},
	LinkedAccounts: 
	{
		Facebook: False,
		Apple: False,
		Google: False
	},
	StreamSettings: 
	{
		ActivityFilters: 
		[
			Events
		]
	}
}