YM REST Services

<back to all web services

ConnectionSuggestions

Requires Authentication
Requires any of the roles:member, oauthmemberRequired permission:CanHaveBuddyList
The following routes are available for this service:
GET/Ams/{ClientID}/Member/{MemberID}/ConnectionSuggestionsReturn a list of member suggested connections.
ConnectionSuggestions Parameters:
NameParameterData TypeRequiredDescription
PageSizequeryint?No
PageNumberqueryint?No
Offsetqueryint?No
MemberBaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
MemberIDformintNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
ConnectionSuggestionsResponse Parameters:
NameParameterData TypeRequiredDescription
ConnectionSuggestionsListformList<Connection>No
TotalResultsCountformintNo
Connection Parameters:
NameParameterData TypeRequiredDescription
ConnectionStatusformConnectionStatus?No
ConnectionIdformintNo
FirstNameformstringNo
LastNameformstringNo
ConnectionNameformstringNo
OrganizationformstringNo
HeadShotImageformstringNo
WorkTitleformstringNo
MemberTypeformstringNo
CityformstringNo
StateformstringNo
LocationformstringNo
CountryformstringNo
SharedformboolNo
EmailformstringNo
PhoneLabelformstringNo
PhoneAreaCodeformstringNo
PhoneNumberformstringNo
FaxLabelformstringNo
FaxAreaCodeformstringNo
FaxNumberformstringNo
CanShowformShowPreferencesNo
intCategoryIDformintNo
IsAmbassadorformboolNo
ShowPreferences Parameters:
NameParameterData TypeRequiredDescription
CityformboolNo
LocationformboolNo
CountryformboolNo
PhoneformboolNo
FaxformboolNo
EmailformboolNo
EmployerNameformboolNo
EmployerTitleformboolNo

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 /Ams/{ClientID}/Member/{MemberID}/ConnectionSuggestions HTTP/1.1 
Host: ws.yourmembership.com 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	ConnectionSuggestionsList: 
	[
		{
			ConnectionStatus: None,
			ConnectionId: 0,
			FirstName: String,
			LastName: String,
			ConnectionName: String,
			Organization: String,
			HeadShotImage: String,
			WorkTitle: String,
			MemberType: String,
			City: String,
			State: String,
			Location: String,
			Country: String,
			Shared: False,
			Email: String,
			PhoneLabel: String,
			PhoneAreaCode: String,
			PhoneNumber: String,
			FaxLabel: String,
			FaxAreaCode: String,
			FaxNumber: String,
			CanShow: 
			{
				City: False,
				Location: False,
				Country: False,
				Phone: False,
				Fax: False,
				Email: False,
				EmployerName: False,
				EmployerTitle: False
			},
			intCategoryID: 0,
			IsAmbassador: False
		}
	],
	TotalResultsCount: 0,
	PageSize: 0,
	PageNumber: 0,
	Offset: 0,
	MemberID: 0,
	ClientID: 0,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	},
	BypassCache: False,
	DateCached: 2024-05-03T05:03:07.0666936-04:00,
	Device: Desktop
}