| All Verbs | /api/contacts/{ContactId}/links |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ContactId | path | Guid | No |
| 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 |
| 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. |
| 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. |
| 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 .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
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: application/json
Content-Type: application/json
Content-Length: length
{"ContactId":"00000000-0000-0000-0000-000000000000"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length
{"Roles":[{"ContactRoleId":"00000000-0000-0000-0000-000000000000","RoleId":"00000000-0000-0000-0000-000000000000","RoleName":"String","RolePrimaryImageURL":"String","RolePrimaryImageThumbnailURL":"String","RolePrimaryImageId":"00000000-0000-0000-0000-000000000000","StartDate":"0001-01-01T00:00:00.0000000","EndDate":"0001-01-01T00:00:00.0000000"}],"ContactConnections":[{"ContactRoleId":"00000000-0000-0000-0000-000000000000","ContactRoleName":"String","ContactListItemRoleId":"00000000-0000-0000-0000-000000000000","ContactRolePrimaryImageURL":"String","ContactRolePrimaryImageThumbnailURL":"String","ContactRolePrimaryImageId":"00000000-0000-0000-0000-000000000000","ConnectionContactId":"00000000-0000-0000-0000-000000000000","ConnectionContactName":"String","ConnectionContactRoleName":"String","ConnectionContactRoleId":"00000000-0000-0000-0000-000000000000","ConnectionContactListItemRoleId":"00000000-0000-0000-0000-000000000000","ContactTypeName":"String","ConnectionContactPhotoURL":"String","IsContactLicenseeRole":false,"IsConnectionLicenseeRole":false,"ConnectionStatusName":"String","ConnectionStatusId":"00000000-0000-0000-0000-000000000000","ConnectionId":"00000000-0000-0000-0000-000000000000","ConnectionRequestId":"00000000-0000-0000-0000-000000000000"}],"EmailAddressBook":[{"ContactId":"00000000-0000-0000-0000-000000000000","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"}}}