| All Verbs | /api/contacts/{ContactId}/connections |
|---|
"use strict";
/** @typedef {'Ascending'|'Descending'} */
export var SortOrder;
(function (SortOrder) {
SortOrder["Ascending"] = "Ascending"
SortOrder["Descending"] = "Descending"
})(SortOrder || (SortOrder = {}));
export class PagedModel {
/** @param {{PageNumber?:number,PageSize?:number,SortIndex?:number,SortOrder?:SortOrder}} [init] */
constructor(init) { Object.assign(this, init) }
/**
* @type {number}
* @description Page Number to retrieve */
PageNumber;
/**
* @type {number}
* @description Number of records to retrieve */
PageSize;
/**
* @type {number}
* @description Index of field to sort results by */
SortIndex;
/**
* @type {SortOrder}
* @description Sort Order - Ascending or Descending */
SortOrder;
}
export class ContactSummaryModel {
/** @param {{ContactId?:string,ContactFullName?:string,EmailAddress?:string,MobileNumber?:string,PhoneNumber?:string,ContactTypeId?:string,ProfilePhotoUrl?:string,ProfilePhotoThumbnailUrl?:string,Description?:string,EmploymentIndustry?:string,EmploymentRole?:string,EmploymentGeographicArea?:string,TimezoneName?:string,PrimaryAddress?:string,IsRemovedContact?:boolean}} [init] */
constructor(init) { Object.assign(this, init) }
/**
* @type {string}
* @description Contact linked to the profile */
ContactId;
/**
* @type {string}
* @description Full name of the contact linked to the profile */
ContactFullName;
/**
* @type {string}
* @description Email Address of the contact linked to the profile */
EmailAddress;
/**
* @type {string}
* @description Mobile Number of the contact linked to the profile */
MobileNumber;
/**
* @type {string}
* @description Primary Phone Number of the contact linked to the profile */
PhoneNumber;
/**
* @type {string}
* @description Type of contact (person, organisation etc.) linked to the profile */
ContactTypeId;
/**
* @type {string}
* @description Profile photo of contact linked to the profile */
ProfilePhotoUrl;
/**
* @type {string}
* @description Thumbnail photo of contact linked to the profile */
ProfilePhotoThumbnailUrl;
/**
* @type {string}
* @description Profile description */
Description;
/**
* @type {string}
* @description Employment Industry */
EmploymentIndustry;
/**
* @type {string}
* @description Employment Role */
EmploymentRole;
/**
* @type {string}
* @description Areas of Work */
EmploymentGeographicArea;
/**
* @type {string}
* @description Timezone Name */
TimezoneName;
/**
* @type {string}
* @description The primary address of the contact */
PrimaryAddress;
/**
* @type {boolean}
* @description Have all connections to the contact been removed? */
IsRemovedContact;
}
export class ContactConnectionModel {
/** @param {{ConnectionId?:string,ConnectionRequestId?:string,Contact?:ContactSummaryModel,ContactRoleId?:string,ContactRoleName?:string,RequestorContactId?:string,RequestorContactName?:string,RequestorRoleId?:string,RequestorRoleName?:string,PrimaryRoleName?:string,ConnectionStatusId?:string,ConnectionStatusName?:string,IsConnectionRequest?:boolean,IsIncoming?:boolean,FromDate?:string,SuggesterContact?:ContactSummaryModel,AllowCancel?:boolean,AllowRemove?:boolean}} [init] */
constructor(init) { Object.assign(this, init) }
/**
* @type {?string}
* @description Connection Id (if applicable) */
ConnectionId;
/**
* @type {?string}
* @description Connection Request Id (if applicable) */
ConnectionRequestId;
/**
* @type {ContactSummaryModel}
* @description Details of the contact */
Contact;
/**
* @type {string}
* @description Contact's role Id in the connection */
ContactRoleId;
/**
* @type {string}
* @description Contact's role name in the connection */
ContactRoleName;
/**
* @type {string}
* @description Requestor Contact Id */
RequestorContactId;
/**
* @type {string}
* @description Requestor Contact Name */
RequestorContactName;
/**
* @type {string}
* @description Requestor contact's role Id in the connection */
RequestorRoleId;
/**
* @type {string}
* @description Requestor's role name in the connection */
RequestorRoleName;
/**
* @type {string}
* @description Primary role in the connection to display */
PrimaryRoleName;
/**
* @type {string}
* @description Connection Status Id */
ConnectionStatusId;
/**
* @type {string}
* @description Connection Status Name */
ConnectionStatusName;
/**
* @type {boolean}
* @description Is this a pending connection request? */
IsConnectionRequest;
/**
* @type {boolean}
* @description Is this an incoming connection request? */
IsIncoming;
/** @type {?string} */
FromDate;
/**
* @type {ContactSummaryModel}
* @description Details of the contact suggesting this connection */
SuggesterContact;
/**
* @type {boolean}
* @description Can this connection be cancelled? */
AllowCancel;
/**
* @type {boolean}
* @description Can this connection be removed? */
AllowRemove;
}
export class GetConnectionsToContactResponse {
/** @param {{Connections?:ContactConnectionModel[],TotalConnections?:number,ResponseStatus?:ResponseStatus}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {ContactConnectionModel[]} */
Connections;
/** @type {number} */
TotalConnections;
/** @type {ResponseStatus} */
ResponseStatus;
}
export class GetConnectionsToContact extends PagedModel {
/** @param {{ContactId?:string,ContactTypeId?:string,RequestorContactId?:string,IsPagedMode?:boolean,IncludeRemoved?:boolean,PageNumber?:number,PageSize?:number,SortIndex?:number,SortOrder?:SortOrder}} [init] */
constructor(init) { super(init); Object.assign(this, init) }
/**
* @type {string}
* @description Contact Id to get connections for */
ContactId;
/**
* @type {string}
* @description Type of the contact to get connections for (i.e. Real/ virtual Person/ Organisation) */
ContactTypeId;
/**
* @type {string}
* @description Contact Id requesting the details - Current user or licensee */
RequestorContactId;
/**
* @type {boolean}
* @description Return all connections or paged results? */
IsPagedMode;
/**
* @type {boolean}
* @description Option to return removed connections */
IncludeRemoved;
}
JavaScript GetConnectionsToContact DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /api/contacts/{ContactId}/connections HTTP/1.1
Host: pfapi.pstpf.com.au
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
IsPagedMode: False,
IncludeRemoved: False,
PageNumber: 0,
PageSize: 0,
SortIndex: 0,
SortOrder: Ascending
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
Connections:
[
{
ConnectionId: 00000000000000000000000000000000,
ConnectionRequestId: 00000000000000000000000000000000,
Contact:
{
ContactFullName: String,
EmailAddress: String,
MobileNumber: String,
PhoneNumber: String,
ProfilePhotoUrl: String,
ProfilePhotoThumbnailUrl: String,
Description: String,
EmploymentIndustry: String,
EmploymentRole: String,
EmploymentGeographicArea: String,
TimezoneName: String,
PrimaryAddress: String,
IsRemovedContact: False
},
ContactRoleName: String,
RequestorContactName: String,
RequestorRoleName: String,
PrimaryRoleName: String,
ConnectionStatusName: String,
IsConnectionRequest: False,
IsIncoming: False,
FromDate: 0001-01-01,
SuggesterContact:
{
ContactFullName: String,
EmailAddress: String,
MobileNumber: String,
PhoneNumber: String,
ProfilePhotoUrl: String,
ProfilePhotoThumbnailUrl: String,
Description: String,
EmploymentIndustry: String,
EmploymentRole: String,
EmploymentGeographicArea: String,
TimezoneName: String,
PrimaryAddress: String,
IsRemovedContact: False
},
AllowCancel: False,
AllowRemove: False
}
],
TotalConnections: 0,
ResponseStatus:
{
ErrorCode: String,
Message: String,
StackTrace: String,
Errors:
[
{
ErrorCode: String,
FieldName: String,
Message: String,
Meta:
{
String: String
}
}
],
Meta:
{
String: String
}
}
}