Platform API

ContactConnectedLinks

Retrieve links to a contact (connections/roles/emailAddressBook

The following routes are available for this service:
All Verbs	/api/contacts/{ContactId}/links

**ContactConnectedLinks** Parameters:
Name	Parameter	Data Type	Required	Description
ContactId	path	Guid	No

**ContactConnectedLinksResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Roles	query	List<UserRoleModel>	No	A list of roles assigned to the contact/user.
ContactConnections	query	List<UserContactConnectionModel>	No	A list of contact connections assigned to the contact/user.
EmailAddressBook	query	List<ContactEmailAddressBook>	No	A list of connected contacts and their email addresses.
ResponseStatus	form	ResponseStatus	No

**UserRoleModel** Parameters:
Name	Parameter	Data Type	Required	Description
ContactRoleId	query	Guid	No	The Contact Role Id, that links the Contact to their role.
RoleId	query	Guid	No	The Role Id.
RoleName	query	string	No	The role name.
RolePrimaryImageURL	query	string	No	The URL of the role's image icon.
RolePrimaryImageThumbnailURL	query	string	No	The URL of the role's thumbnail image icon.
RolePrimaryImageId	query	string	No	The Guid of the role's media file containing the image icon details.
StartDate	query	DateTime	No	The date the contact started having this role.
EndDate	query	DateTime?	No	The date the contact will end having this role.

**UserContactConnectionModel** Parameters:
Name	Parameter	Data Type	Required	Description
ContactRoleId	query	Guid	No	The Contact Role Id, that links the Contact to their role.
ContactRoleName	query	string	No	The role name.
ContactListItemRoleId	query	Guid	No	The list item role Id.
ContactRolePrimaryImageURL	query	string	No	The URL of the contact role's image icon.
ContactRolePrimaryImageThumbnailURL	query	string	No	The URL of the contact role's thumbnail image icon.
ContactRolePrimaryImageId	query	string	No	The Guid of the contact role's media file containing the image icon details.
ConnectionContactId	query	string	No	The connected contacts Id. (licensee)
ConnectionContactName	query	string	No	The connected contacts Full Name.
ConnectionContactRoleName	query	string	No	The connected contacts role.
ConnectionContactRoleId	query	Guid	No	The connected contacts role Id.
ConnectionContactListItemRoleId	query	Guid	No	The connected contacts list item role Id.
ContactTypeName	query	string	No	The Contacts Type.
ConnectionContactPhotoURL	query	string	No	The URL to the Connected Contacts Photo.
IsContactLicenseeRole	query	bool	No	.
IsConnectionLicenseeRole	query	bool	No	If the connection is as a licensee this is true.
ConnectionStatusName	query	string	No	The status of the connection with the contact.
ConnectionStatusId	query	Guid	No	The status Id of the connection with the contact.
ConnectionId	query	Guid	No	The ContactRoleConnectionId of an active connection with the contact.
ConnectionRequestId	query	Guid	No	The ContactRoleConnectionRequest of a pending connection with the contact.

**ContactEmailAddress** Parameters:
Name	Parameter	Data Type	Required	Description
ContactId	query	Guid	No	The Contact Id of the contact.
ContactName	query	string	No	The Contact Full Name
EmailAddress	query	string	No	The Contact Email Address.
ContactPhotoURL	query	string	No	The Contact Photo URL

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.

POST /api/contacts/{ContactId}/links HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	
}

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Roles: 
	[
		{
			RoleName: String,
			RolePrimaryImageURL: String,
			RolePrimaryImageThumbnailURL: String,
			StartDate: 0001-01-01,
			EndDate: 0001-01-01
		}
	],
	ContactConnections: 
	[
		{
			ContactRoleName: String,
			ContactRolePrimaryImageURL: String,
			ContactRolePrimaryImageThumbnailURL: String,
			ConnectionContactName: String,
			ConnectionContactRoleName: String,
			ContactTypeName: String,
			ConnectionContactPhotoURL: String,
			IsContactLicenseeRole: False,
			IsConnectionLicenseeRole: False,
			ConnectionStatusName: String
		}
	],
	EmailAddressBook: 
	[
		{
			ContactName: String,
			EmailAddress: String,
			ContactPhotoURL: String
		}
	],
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	}
}