BokaMera.API.Host

<back to all web services

MessageLogQuery

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, superadmin, bookingsupplier-administrator-read
The following routes are available for this service:
GET/messages/logSearch the message log for any messagesSearch the message log for any messages.
MessageLogQuery Parameters:
NameParameterData TypeRequiredDescription
CompanyIdpathGuid?NoThe company id, if empty will use the company id for the user you are logged in with.
SentquerybooleanNoIf you want to search on sent messages
IdqueryintNoMessage Id
BookingIdqueryintNoIf you want to search on a messages for a specific booking
ReceiverquerystringNoIf you want to search on a messages for a specific receiver
CreatedquerydatetimeNoIf you want to search on a messages created a specific date
SentDatequerydatetimeNoIf you want to search on a messages sent a specific date
ResponseStatusqueryResponseStatusNo
QueryBase Parameters:
NameParameterData TypeRequiredDescription
SkipqueryintNoSkip over a given number of elements in a sequence and then return the remainder. Use this when you need paging.

Example:
?skip=10&orderBy=Id
TakequeryintNoReturn a given number of elements in a sequence and then skip over the remainder. Use this when you need paging.

Example:
?take=20
OrderByquerystringNoComma separated list of fields to order by. Prefix the field name with a minus if you wan't to invert the sort for that field.

Example:
?orderBy=Id,-Age,FirstName
OrderByDescquerystringNoComma separated list of fields to order by in descending order. Prefix the field name with a minus if you wan't to invert the sort for that field.

Example:
?orderByDesc=Id,-Age,FirstName
IncludequerystringNoInclude any of the aggregates AVG, COUNT, FIRST, LAST, MAX, MIN, SUM in your result set. The results will be returned in the meta field.

Example:
?include=COUNT(*) as Total

or multiple fields with
?include=Count(*) Total, Min(Age), AVG(Age) AverageAge

or unique with
?include=COUNT(DISTINCT LivingStatus) as UniqueStatus
FieldsformstringNo
MetaformDictionary<string, string>No
MessageLog Parameters:
NameParameterData TypeRequiredDescription
BookingIdformint?No
PublicMessageformboolYes
MessageTypeformintYes
iCalAttachmentformboolYes
SenderNameformstringYes
ModifiedDateformDateTimeOffset?No
CorrelationIdformGuid?No
CompanyIdformGuidYes
IdformintNo
ReceiverformstringYes
SenderformstringYes
MessageTitleformstringNo
MessageBodyformstringYes
CreatedByformstringNo
CreatedformDateTimeYes
SentformboolYes
ToSendDateformDateTimeYes
SentDateformDateTime?No
SendMethodIdformintYes
MessageCountformint?No
SMSStatusformint?No
MessageRetriesformintYes
StorageUrlformstringNo
LanguageformstringNo
MessageLogQueryResponse Parameters:
NameParameterData TypeRequiredDescription
IdformintNoThe message log id
BookingIdformint?NoThe booking id for the message (if connected to a booking).
ReceiverformstringNoThe message receiver. Either a email or a mobile phone number.
MessageTitleformstringNoMessage Title.
StorageUrlformstringNoMessage Storage Url.
MessageBodyformstringNoMessage Body.
CreatedformDateTimeNoWhen message was created.
ToSendDateformDateTimeNoWhen the message will be sent.
SentDateformDateTime?NoWhen the message was sent.
SentformboolNoIf Message is sent
MessageRetriesformintNoNumber of retries to send the message
SendMethodIdformintNoSend Method. 1 = Email, 2 = SMS
QueryResponse<AccessKeyTypeResponse> Parameters:
NameParameterData TypeRequiredDescription
OffsetformintNo
TotalformintNo
ResultsformList<AccessKeyTypeResponse>No
MetaformDictionary<string, string>No
ResponseStatusformResponseStatusNo
AccessKeyTypeResponse Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
KeyTypeformstringNo
DescriptionformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv

HTTP + CSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /messages/log HTTP/1.1 
Host: testapi.bokamera.se 
Accept: text/csv
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{"Offset":0,"Total":0,"Results":[{"Id":0,"BookingId":0,"Receiver":"String","MessageTitle":"String","StorageUrl":"String","MessageBody":"String","SentDate":"0001-01-01T00:00:00","Sent":false,"MessageRetries":0,"SendMethodId":0}],"Meta":{"String":"String"},"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}}}