YM REST Services

<back to all web services

Connections

Requires Authentication
Requires any of the roles:member, oauthmemberRequired permission:CanHaveBuddyList
The following routes are available for this service:
GET/Ams/{ClientID}/Member/{MemberID}/ConnectionsReturn a list of member connections filtered by status.
POST/Ams/{ClientID}/Member/{MemberID}/ConnectionsSend a connection request to another member.
PUT/Ams/{ClientID}/Member/{MemberID}/ConnectionsApprove a pending request.
DELETE/Ams/{ClientID}/Member/{MemberID}/Connections/{ConnectionId}Remove an existing connection or pending request.
PUT/Ams/{ClientID}/Member/{MemberID}/Connections/{ConnectionId}Approve a pending request.
Connections Parameters:
NameParameterData TypeRequiredDescription
ConnectionFilterbodyConnectionFilter?No

Allowable Values

  • Sent
  • Received
ConnectionIdpathintNo
CategoryIdbodyint?No
PageSizebodyintNo
PageNumberbodyintNo
OffSetbodyintNo
MessagebodystringNo
NameTermbodystringNo
MemberBaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
MemberIDformintNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
ConnectionsResponse Parameters:
NameParameterData TypeRequiredDescription
ConnectionsListformList<Connection>No
ConnectionStatusformConnectionStatus?No
Successformbool?No
TotalResultsCountformintNo
TargetMemberNameformstringNo
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 .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

POST /Ams/{ClientID}/Member/{MemberID}/Connections HTTP/1.1 
Host: ws.yourmembership.com 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"ConnectionFilter":"0","ConnectionId":0,"CategoryId":0,"PageSize":0,"PageNumber":0,"OffSet":0,"Message":"String","NameTerm":"String","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-03T04:04:57.3800279-04:00","Device":"Desktop"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"ConnectionsList":[{"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}],"ConnectionStatus":"None","Success":false,"TotalResultsCount":0,"TargetMemberName":"String","ConnectionFilter":"0","ConnectionId":0,"CategoryId":0,"PageSize":0,"PageNumber":0,"OffSet":0,"Message":"String","NameTerm":"String","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-03T04:04:57.3800279-04:00","Device":"Desktop"}