YM REST Services

<back to all web services

TopContributors

Requires Authentication
Requires any of the roles:admin, oauthadmin, member, oauthmember
The following routes are available for this service:
GET/Ams/{ClientID}/TopContributorsReturn a list of TopContributors for the Admin.
GET/Ams/{ClientID}/Member/{MemberID}/TopContributorsReturn a list of TopContributors for the Member.
TopContributors Parameters:
NameParameterData TypeRequiredDescription
DateBeginqueryDateTimeNo
DateEndqueryDateTimeNo
PageNumberqueryintNo
PageSizequeryintNo
MemberBaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
MemberIDformintNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
TopContributorsResponse Parameters:
NameParameterData TypeRequiredDescription
CurrentContributorformTopContributorNo
ContributorListformList<TopContributor>No
TopContributor Parameters:
NameParameterData TypeRequiredDescription
RankNumberformintNo
RankPercentageformintNo
RankBaselineformintNo
ScoreformintNo
PostCountformintNo
CommentCountformintNo
LikeCountformintNo
LevelIdformintNo
LevelNameformstringNo
DisplayOptionsformDisplayOptionsNo
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
DisplayOptions Parameters:
NameParameterData TypeRequiredDescription
ShowOnlineNowformboolNo
ShowOrganizationformboolNo
ShowMessageButtonformboolNo
ShowConnectButtonformboolNo
ShowIMUsernameformboolNo
ShowNickNameformboolNo
ShowMaidenNameformboolNo
ShowBirthdayDateformboolNo
ShowMarriageStatusformboolNo
ShowWeddingDateformboolNo
ShowSpouseformboolNo
ShowPrimaryEmailformboolNo
ShowHomeAddressformboolNo
ShowHomeAddress2formboolNo
ShowHomeCityformboolNo
ShowHomeZipformboolNo
ShowHomePhoneformboolNo
ShowHomeFaxformboolNo
ShowWorkAddressformboolNo
ShowWorkAddress2formboolNo
ShowWorkCityformboolNo
ShowWorkZipformboolNo
ShowWorkPhoneformboolNo
ShowWorkFaxformboolNo
ShowEmployerNameformboolNo
ShowEmployerTitleformboolNo
ShowEmployerLocationformboolNo
ShowEmployerOwnsBusinessformboolNo
ShowHomeCountryformboolNo
ShowHomeLocationformboolNo
ShowWorkCountryformboolNo
ShowResumeformboolNo
ProfilePhotoformboolNo
ShowGameBadgeformboolNo

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.

GET /Ams/{ClientID}/TopContributors HTTP/1.1 
Host: ws.yourmembership.com 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"CurrentContributor":{"RankNumber":0,"RankPercentage":0,"RankBaseline":0,"Score":0,"PostCount":0,"CommentCount":0,"LikeCount":0,"LevelId":0,"LevelName":"String","DisplayOptions":{"ShowOnlineNow":false,"ShowOrganization":false,"ShowMessageButton":false,"ShowConnectButton":false,"ShowIMUsername":false,"ShowNickName":false,"ShowMaidenName":false,"ShowBirthdayDate":false,"ShowMarriageStatus":false,"ShowWeddingDate":false,"ShowSpouse":false,"ShowPrimaryEmail":false,"ShowHomeAddress":false,"ShowHomeAddress2":false,"ShowHomeCity":false,"ShowHomeZip":false,"ShowHomePhone":false,"ShowHomeFax":false,"ShowWorkAddress":false,"ShowWorkAddress2":false,"ShowWorkCity":false,"ShowWorkZip":false,"ShowWorkPhone":false,"ShowWorkFax":false,"ShowEmployerName":false,"ShowEmployerTitle":false,"ShowEmployerLocation":false,"ShowEmployerOwnsBusiness":false,"ShowHomeCountry":false,"ShowHomeLocation":false,"ShowWorkCountry":false,"ShowResume":false,"ProfilePhoto":false,"ShowGameBadge":false},"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},"ContributorList":[{"RankNumber":0,"RankPercentage":0,"RankBaseline":0,"Score":0,"PostCount":0,"CommentCount":0,"LikeCount":0,"LevelId":0,"LevelName":"String","DisplayOptions":{"ShowOnlineNow":false,"ShowOrganization":false,"ShowMessageButton":false,"ShowConnectButton":false,"ShowIMUsername":false,"ShowNickName":false,"ShowMaidenName":false,"ShowBirthdayDate":false,"ShowMarriageStatus":false,"ShowWeddingDate":false,"ShowSpouse":false,"ShowPrimaryEmail":false,"ShowHomeAddress":false,"ShowHomeAddress2":false,"ShowHomeCity":false,"ShowHomeZip":false,"ShowHomePhone":false,"ShowHomeFax":false,"ShowWorkAddress":false,"ShowWorkAddress2":false,"ShowWorkCity":false,"ShowWorkZip":false,"ShowWorkPhone":false,"ShowWorkFax":false,"ShowEmployerName":false,"ShowEmployerTitle":false,"ShowEmployerLocation":false,"ShowEmployerOwnsBusiness":false,"ShowHomeCountry":false,"ShowHomeLocation":false,"ShowWorkCountry":false,"ShowResume":false,"ProfilePhoto":false,"ShowGameBadge":false},"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}],"DateBegin":"0001-01-01T00:00:00.0000000","DateEnd":"0001-01-01T00:00:00.0000000","PageNumber":0,"PageSize":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-03T07:12:18.8426727-04:00","Device":"Desktop"}