Platform API

<back to all web services

GetConnectionRequests

Requires Authentication
The following routes are available for this service:
All Verbs/api/contacts/{ContactId}/connectionrequests/received
All Verbs/api/contacts/{ContactId}/connectionrequests/sent
import java.math.*;
import java.util.*;
import java.io.InputStream;
import net.servicestack.client.*;

public class dtos
{

    public static class GetConnectionRequests
    {
        /**
        * Contact to get connection requests for
        */
        @ApiMember(Description="Contact to get connection requests for", IsRequired=true, Name="ContactId")
        public UUID ContactId = null;

        /**
        * Filter connection requests for the specified contact types
        */
        @ApiMember(Description="Filter connection requests for the specified contact types", IsRequired=true, Name="ContactTypes")
        public ArrayList<UUID> ContactTypes = new ArrayList<UUID>();

        /**
        * Include ignored connection requests?
        */
        @ApiMember(Description="Include ignored connection requests?", IsRequired=true, Name="IncludeIgnoredRequests")
        public Boolean IncludeIgnoredRequests = null;
        
        public UUID getContactId() { return ContactId; }
        public GetConnectionRequests setContactId(UUID value) { this.ContactId = value; return this; }
        public ArrayList<UUID> getContactTypes() { return ContactTypes; }
        public GetConnectionRequests setContactTypes(ArrayList<UUID> value) { this.ContactTypes = value; return this; }
        public Boolean isIncludeIgnoredRequests() { return IncludeIgnoredRequests; }
        public GetConnectionRequests setIncludeIgnoredRequests(Boolean value) { this.IncludeIgnoredRequests = value; return this; }
    }

    public static class GetConnectionRequestsResponse
    {
        public ArrayList<ContactConnectionModel> ConnectionRequests = null;
        public ResponseStatus ResponseStatus = null;
        
        public ArrayList<ContactConnectionModel> getConnectionRequests() { return ConnectionRequests; }
        public GetConnectionRequestsResponse setConnectionRequests(ArrayList<ContactConnectionModel> value) { this.ConnectionRequests = value; return this; }
        public ResponseStatus getResponseStatus() { return ResponseStatus; }
        public GetConnectionRequestsResponse setResponseStatus(ResponseStatus value) { this.ResponseStatus = value; return this; }
    }

    public static class ContactConnectionModel
    {
        /**
        * Connection Id (if applicable)
        */
        @ApiMember(DataType="Guid?", Description="Connection Id (if applicable)", Name="ConnectionId")
        public UUID ConnectionId = null;

        /**
        * Connection Request Id (if applicable)
        */
        @ApiMember(DataType="Guid?", Description="Connection Request Id (if applicable)", Name="ConnectionRequestId")
        public UUID ConnectionRequestId = null;

        /**
        * Details of the contact
        */
        @ApiMember(DataType="ContactSummaryModel", Description="Details of the contact", IsRequired=true, Name="Contact")
        public ContactSummaryModel Contact = null;

        /**
        * Contact's role Id in the connection
        */
        @ApiMember(DataType="Guid", Description="Contact's role Id in the connection", IsRequired=true, Name="ContactRoleId")
        public UUID ContactRoleId = null;

        /**
        * Contact's role name in the connection
        */
        @ApiMember(DataType="string", Description="Contact's role name in the connection", Name="ContactRoleName")
        public String ContactRoleName = null;

        /**
        * Requestor Contact Id
        */
        @ApiMember(DataType="Guid", Description="Requestor Contact Id", IsRequired=true, Name="RequestorContactId")
        public UUID RequestorContactId = null;

        /**
        * Requestor Contact Name
        */
        @ApiMember(DataType="Guid", Description="Requestor Contact Name", Name="RequestorContactName")
        public String RequestorContactName = null;

        /**
        * Requestor contact's role Id in the connection
        */
        @ApiMember(DataType="Guid", Description="Requestor contact's role Id in the connection", IsRequired=true, Name="RequestorRoleId")
        public UUID RequestorRoleId = null;

        /**
        * Requestor's role name in the connection
        */
        @ApiMember(DataType="string", Description="Requestor's role name in the connection", Name="RequestorRoleName")
        public String RequestorRoleName = null;

        /**
        * Primary role in the connection to display
        */
        @ApiMember(DataType="string", Description="Primary role in the connection to display", Name="PrimaryRoleName")
        public String PrimaryRoleName = null;

        /**
        * Connection Status Id
        */
        @ApiMember(DataType="Guid", Description="Connection Status Id", IsRequired=true, Name="ConnectionStatusId")
        public UUID ConnectionStatusId = null;

        /**
        * Connection Status Name
        */
        @ApiMember(DataType="string", Description="Connection Status Name", Name="ConnectionStatusName")
        public String ConnectionStatusName = null;

        /**
        * Is this a pending connection request?
        */
        @ApiMember(DataType="bool", Description="Is this a pending connection request?", Name="IsConnectionRequest")
        public Boolean IsConnectionRequest = null;

        /**
        * Is this an incoming connection request?
        */
        @ApiMember(DataType="bool", Description="Is this an incoming connection request?", Name="IsIncoming")
        public Boolean IsIncoming = null;

        public Date FromDate = null;
        /**
        * Details of the contact suggesting this connection
        */
        @ApiMember(DataType="ContactSummaryModel", Description="Details of the contact suggesting this connection", IsRequired=true, Name="SuggesterContact")
        public ContactSummaryModel SuggesterContact = null;

        /**
        * Can this connection be cancelled?
        */
        @ApiMember(DataType="bool", Description="Can this connection be cancelled?", Name="AllowCancel")
        public Boolean AllowCancel = null;

        /**
        * Can this connection be removed?
        */
        @ApiMember(DataType="bool", Description="Can this connection be removed?", Name="AllowRemove")
        public Boolean AllowRemove = null;
        
        public UUID getConnectionId() { return ConnectionId; }
        public ContactConnectionModel setConnectionId(UUID value) { this.ConnectionId = value; return this; }
        public UUID getConnectionRequestId() { return ConnectionRequestId; }
        public ContactConnectionModel setConnectionRequestId(UUID value) { this.ConnectionRequestId = value; return this; }
        public ContactSummaryModel getContact() { return Contact; }
        public ContactConnectionModel setContact(ContactSummaryModel value) { this.Contact = value; return this; }
        public UUID getContactRoleId() { return ContactRoleId; }
        public ContactConnectionModel setContactRoleId(UUID value) { this.ContactRoleId = value; return this; }
        public String getContactRoleName() { return ContactRoleName; }
        public ContactConnectionModel setContactRoleName(String value) { this.ContactRoleName = value; return this; }
        public UUID getRequestorContactId() { return RequestorContactId; }
        public ContactConnectionModel setRequestorContactId(UUID value) { this.RequestorContactId = value; return this; }
        public String getRequestorContactName() { return RequestorContactName; }
        public ContactConnectionModel setRequestorContactName(String value) { this.RequestorContactName = value; return this; }
        public UUID getRequestorRoleId() { return RequestorRoleId; }
        public ContactConnectionModel setRequestorRoleId(UUID value) { this.RequestorRoleId = value; return this; }
        public String getRequestorRoleName() { return RequestorRoleName; }
        public ContactConnectionModel setRequestorRoleName(String value) { this.RequestorRoleName = value; return this; }
        public String getPrimaryRoleName() { return PrimaryRoleName; }
        public ContactConnectionModel setPrimaryRoleName(String value) { this.PrimaryRoleName = value; return this; }
        public UUID getConnectionStatusId() { return ConnectionStatusId; }
        public ContactConnectionModel setConnectionStatusId(UUID value) { this.ConnectionStatusId = value; return this; }
        public String getConnectionStatusName() { return ConnectionStatusName; }
        public ContactConnectionModel setConnectionStatusName(String value) { this.ConnectionStatusName = value; return this; }
        public Boolean getIsConnectionRequest() { return IsConnectionRequest; }
        public ContactConnectionModel setIsConnectionRequest(Boolean value) { this.IsConnectionRequest = value; return this; }
        public Boolean getIsIncoming() { return IsIncoming; }
        public ContactConnectionModel setIsIncoming(Boolean value) { this.IsIncoming = value; return this; }
        public Date getFromDate() { return FromDate; }
        public ContactConnectionModel setFromDate(Date value) { this.FromDate = value; return this; }
        public ContactSummaryModel getSuggesterContact() { return SuggesterContact; }
        public ContactConnectionModel setSuggesterContact(ContactSummaryModel value) { this.SuggesterContact = value; return this; }
        public Boolean isAllowCancel() { return AllowCancel; }
        public ContactConnectionModel setAllowCancel(Boolean value) { this.AllowCancel = value; return this; }
        public Boolean isAllowRemove() { return AllowRemove; }
        public ContactConnectionModel setAllowRemove(Boolean value) { this.AllowRemove = value; return this; }
    }

    public static class ContactSummaryModel
    {
        /**
        * Contact linked to the profile
        */
        @ApiMember(DataType="Guid", Description="Contact linked to the profile", Name="ContactId")
        public UUID ContactId = null;

        /**
        * Full name of the contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Full name of the contact linked to the profile", Name="ContactFullName")
        public String ContactFullName = null;

        /**
        * Email Address of the contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Email Address of the contact linked to the profile", Name="EmailAddress")
        public String EmailAddress = null;

        /**
        * Mobile Number of the contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Mobile Number of the contact linked to the profile", Name="MobileNumber")
        public String MobileNumber = null;

        /**
        * Primary Phone Number of the contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Primary Phone Number of the contact linked to the profile", Name="PhoneNumber")
        public String PhoneNumber = null;

        /**
        * Type of contact (person, organisation etc.) linked to the profile
        */
        @ApiMember(DataType="string", Description="Type of contact (person, organisation etc.) linked to the profile", Name="ContactTypeId")
        public UUID ContactTypeId = null;

        /**
        * Profile photo of contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Profile photo of contact linked to the profile", Name="ProfilePhotoUrl")
        public String ProfilePhotoUrl = null;

        /**
        * Thumbnail photo of contact linked to the profile
        */
        @ApiMember(DataType="string", Description="Thumbnail photo of contact linked to the profile", Name="ProfilePhotoThumbnailUrl")
        public String ProfilePhotoThumbnailUrl = null;

        /**
        * Profile description
        */
        @ApiMember(DataType="string", Description="Profile description", Name="Description")
        public String Description = null;

        /**
        * Employment Industry
        */
        @ApiMember(DataType="string", Description="Employment Industry", Name="EmploymentIndustry")
        public String EmploymentIndustry = null;

        /**
        * Employment Role
        */
        @ApiMember(DataType="string", Description="Employment Role", Name="EmploymentRole")
        public String EmploymentRole = null;

        /**
        * Areas of Work
        */
        @ApiMember(DataType="string", Description="Areas of Work", Name="EmploymentGeographicArea")
        public String EmploymentGeographicArea = null;

        /**
        * Timezone Name
        */
        @ApiMember(DataType="string", Description="Timezone Name", Name="TimezoneName", ParameterType="query")
        public String TimezoneName = null;

        /**
        * The primary address of the contact
        */
        @ApiMember(DataType="string", Description="The primary address of the contact", Name="PrimaryAddress", ParameterType="query")
        public String PrimaryAddress = null;

        /**
        * Have all connections to the contact been removed?
        */
        @ApiMember(DataType="bool", Description="Have all connections to the contact been removed?", Name="IsRemovedContact")
        public Boolean IsRemovedContact = null;
        
        public UUID getContactId() { return ContactId; }
        public ContactSummaryModel setContactId(UUID value) { this.ContactId = value; return this; }
        public String getContactFullName() { return ContactFullName; }
        public ContactSummaryModel setContactFullName(String value) { this.ContactFullName = value; return this; }
        public String getEmailAddress() { return EmailAddress; }
        public ContactSummaryModel setEmailAddress(String value) { this.EmailAddress = value; return this; }
        public String getMobileNumber() { return MobileNumber; }
        public ContactSummaryModel setMobileNumber(String value) { this.MobileNumber = value; return this; }
        public String getPhoneNumber() { return PhoneNumber; }
        public ContactSummaryModel setPhoneNumber(String value) { this.PhoneNumber = value; return this; }
        public UUID getContactTypeId() { return ContactTypeId; }
        public ContactSummaryModel setContactTypeId(UUID value) { this.ContactTypeId = value; return this; }
        public String getProfilePhotoUrl() { return ProfilePhotoUrl; }
        public ContactSummaryModel setProfilePhotoUrl(String value) { this.ProfilePhotoUrl = value; return this; }
        public String getProfilePhotoThumbnailUrl() { return ProfilePhotoThumbnailUrl; }
        public ContactSummaryModel setProfilePhotoThumbnailUrl(String value) { this.ProfilePhotoThumbnailUrl = value; return this; }
        public String getDescription() { return Description; }
        public ContactSummaryModel setDescription(String value) { this.Description = value; return this; }
        public String getEmploymentIndustry() { return EmploymentIndustry; }
        public ContactSummaryModel setEmploymentIndustry(String value) { this.EmploymentIndustry = value; return this; }
        public String getEmploymentRole() { return EmploymentRole; }
        public ContactSummaryModel setEmploymentRole(String value) { this.EmploymentRole = value; return this; }
        public String getEmploymentGeographicArea() { return EmploymentGeographicArea; }
        public ContactSummaryModel setEmploymentGeographicArea(String value) { this.EmploymentGeographicArea = value; return this; }
        public String getTimezoneName() { return TimezoneName; }
        public ContactSummaryModel setTimezoneName(String value) { this.TimezoneName = value; return this; }
        public String getPrimaryAddress() { return PrimaryAddress; }
        public ContactSummaryModel setPrimaryAddress(String value) { this.PrimaryAddress = value; return this; }
        public Boolean getIsRemovedContact() { return IsRemovedContact; }
        public ContactSummaryModel setIsRemovedContact(Boolean value) { this.IsRemovedContact = value; return this; }
    }

}

Java GetConnectionRequests DTOs

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

HTTP + XML

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

POST /api/contacts/{ContactId}/connectionrequests/received HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<GetConnectionRequests xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eros.Subtle.Canvara.WebAPIModel.ServiceModel">
  <ContactId>00000000-0000-0000-0000-000000000000</ContactId>
  <ContactTypes xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>00000000-0000-0000-0000-000000000000</d2p1:guid>
  </ContactTypes>
  <IncludeIgnoredRequests>false</IncludeIgnoredRequests>
</GetConnectionRequests>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GetConnectionRequestsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eros.Subtle.Canvara.WebAPIModel.ServiceModel">
  <ConnectionRequests xmlns:d2p1="http://schemas.datacontract.org/2004/07/Eros.Saguna.Common.WebAPIModel.Models">
    <d2p1:ContactConnectionModel>
      <d2p1:AllowCancel>false</d2p1:AllowCancel>
      <d2p1:AllowRemove>false</d2p1:AllowRemove>
      <d2p1:ConnectionId>00000000-0000-0000-0000-000000000000</d2p1:ConnectionId>
      <d2p1:ConnectionRequestId>00000000-0000-0000-0000-000000000000</d2p1:ConnectionRequestId>
      <d2p1:ConnectionStatusId>00000000-0000-0000-0000-000000000000</d2p1:ConnectionStatusId>
      <d2p1:ConnectionStatusName>String</d2p1:ConnectionStatusName>
      <d2p1:Contact>
        <d2p1:ContactFullName>String</d2p1:ContactFullName>
        <d2p1:ContactId>00000000-0000-0000-0000-000000000000</d2p1:ContactId>
        <d2p1:ContactTypeId>00000000-0000-0000-0000-000000000000</d2p1:ContactTypeId>
        <d2p1:Description>String</d2p1:Description>
        <d2p1:EmailAddress>String</d2p1:EmailAddress>
        <d2p1:EmploymentGeographicArea>String</d2p1:EmploymentGeographicArea>
        <d2p1:EmploymentIndustry>String</d2p1:EmploymentIndustry>
        <d2p1:EmploymentRole>String</d2p1:EmploymentRole>
        <d2p1:IsRemovedContact>false</d2p1:IsRemovedContact>
        <d2p1:MobileNumber>String</d2p1:MobileNumber>
        <d2p1:PhoneNumber>String</d2p1:PhoneNumber>
        <d2p1:PrimaryAddress>String</d2p1:PrimaryAddress>
        <d2p1:ProfilePhotoThumbnailUrl>String</d2p1:ProfilePhotoThumbnailUrl>
        <d2p1:ProfilePhotoUrl>String</d2p1:ProfilePhotoUrl>
        <d2p1:TimezoneName>String</d2p1:TimezoneName>
      </d2p1:Contact>
      <d2p1:ContactRoleId>00000000-0000-0000-0000-000000000000</d2p1:ContactRoleId>
      <d2p1:ContactRoleName>String</d2p1:ContactRoleName>
      <d2p1:FromDate>0001-01-01T00:00:00</d2p1:FromDate>
      <d2p1:IsIncoming>false</d2p1:IsIncoming>
      <d2p1:PrimaryRoleName>String</d2p1:PrimaryRoleName>
      <d2p1:RequestorContactId>00000000-0000-0000-0000-000000000000</d2p1:RequestorContactId>
      <d2p1:RequestorContactName>String</d2p1:RequestorContactName>
      <d2p1:RequestorRoleId>00000000-0000-0000-0000-000000000000</d2p1:RequestorRoleId>
      <d2p1:RequestorRoleName>String</d2p1:RequestorRoleName>
      <d2p1:SuggesterContact>
        <d2p1:ContactFullName>String</d2p1:ContactFullName>
        <d2p1:ContactId>00000000-0000-0000-0000-000000000000</d2p1:ContactId>
        <d2p1:ContactTypeId>00000000-0000-0000-0000-000000000000</d2p1:ContactTypeId>
        <d2p1:Description>String</d2p1:Description>
        <d2p1:EmailAddress>String</d2p1:EmailAddress>
        <d2p1:EmploymentGeographicArea>String</d2p1:EmploymentGeographicArea>
        <d2p1:EmploymentIndustry>String</d2p1:EmploymentIndustry>
        <d2p1:EmploymentRole>String</d2p1:EmploymentRole>
        <d2p1:IsRemovedContact>false</d2p1:IsRemovedContact>
        <d2p1:MobileNumber>String</d2p1:MobileNumber>
        <d2p1:PhoneNumber>String</d2p1:PhoneNumber>
        <d2p1:PrimaryAddress>String</d2p1:PrimaryAddress>
        <d2p1:ProfilePhotoThumbnailUrl>String</d2p1:ProfilePhotoThumbnailUrl>
        <d2p1:ProfilePhotoUrl>String</d2p1:ProfilePhotoUrl>
        <d2p1:TimezoneName>String</d2p1:TimezoneName>
      </d2p1:SuggesterContact>
    </d2p1:ContactConnectionModel>
  </ConnectionRequests>
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
</GetConnectionRequestsResponse>