Framework API

<back to all web services

GetCommunicationData

Retrieves communications from the Communication database to be saved to Framework

Requires Authentication
GetCommunicationData Parameters:
NameParameterData TypeRequiredDescription
BinRowVersionquerybyte[]NoBin Row Version of the last update
SuiteDataSourceInstanceIdqueryGuidNoSuite Data Source Instance Id to determine which licensees data to retrieve.
BatchNumberqueryintNoBatch Call Number.
BatchSizequeryintNoNumber of records to retrieve per call.
IgnoreValidationqueryboolNo
GetCommunicationDataResponse Parameters:
NameParameterData TypeRequiredDescription
BinRowVersionformbyte[]NoBin Row Version of the last update
CommunicationsformstringNoCommunication Data string (compressed/zipped)
ResponseStatusformResponseStatusNo

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 /jsv/reply/GetCommunicationData HTTP/1.1 
Host: gatewayframeworkapi.pstpf.com.au 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	BinRowVersion: AA==,
	BatchNumber: 0,
	BatchSize: 0,
	IgnoreValidation: True
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	BinRowVersion: AA==,
	Communications: String,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	}
}