CommunicationHub.API

<back to all web services

SendLetter

The following routes are available for this service:
POST/Letter/Send
SendLetter Parameters:
NameParameterData TypeRequiredDescription
FileNamebodystringNo
Filebodybyte[]No
TestFlagbodyboolNo
TestEMailbodystringNo
TestShowRestrictedAreabodyboolNo
BatchIdbodyintNo
CoverLetterbodyboolNo
CoverFilebodybyte[]No
IsColorbodyboolNo
IsDuplexbodyboolNo
AddressLine1bodystringNo
AddressLine2bodystringNo
AddressLine3bodystringNo
AddressLine4bodystringNo
AddressLine5bodystringNo
ZipCodebodystringNo
CitybodystringNo
CountrybodystringNo
SenderAdressLine1bodystringNo
SenderStreetbodystringNo
SenderZipCodebodystringNo
SenderCitybodystringNo
ReferencebodystringNo
SendResponse Parameters:
NameParameterData TypeRequiredDescription
MessageIdformstringNo
SenderformstringNo
ReceiverformstringNo
StatusformStatusNo
ErrorMessageformstringNo
ConfigurationformstringNo
RetryformboolNo
RetryCountformintNo
Status Enum:
accepted
queued
sending
sent
failed
delivered
undelivered
receiving
received
read
pickedup
unknown

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 /Letter/Send HTTP/1.1 
Host: communicationhub.carelogic-cloud.de 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	FileName: String,
	File: AA==,
	TestFlag: False,
	TestEMail: String,
	TestShowRestrictedArea: False,
	BatchId: 0,
	CoverLetter: False,
	CoverFile: AA==,
	IsColor: False,
	IsDuplex: False,
	AddressLine1: String,
	AddressLine2: String,
	AddressLine3: String,
	AddressLine4: String,
	AddressLine5: String,
	ZipCode: String,
	City: String,
	Country: String,
	SenderAdressLine1: String,
	SenderStreet: String,
	SenderZipCode: String,
	SenderCity: String,
	Reference: String
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	MessageId: String,
	Sender: String,
	Receiver: String,
	Status: accepted,
	ErrorMessage: String,
	Configuration: String,
	Retry: False,
	RetryCount: 0
}