BokaMera.API.Host

<back to all web services

SendSMS

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, superadmin, bookingsupplier-administrator-read
The following routes are available for this service:
POST/messages/sendsmsSend email to any mobile phone recipientSend SMS to any mobile phone recipient.
Imports System
Imports System.Collections
Imports System.Collections.Generic
Imports System.Runtime.Serialization
Imports ServiceStack
Imports ServiceStack.DataAnnotations
Imports BokaMera.API.ServiceModel.Dtos

Namespace Global

    Namespace BokaMera.API.ServiceModel.Dtos

        Public Partial Class MessageLogQueryResponse
            '''<Summary>
            '''The message log id
            '''</Summary>
            <ApiMember(Description:="The message log id")>
            Public Overridable Property Id As Integer

            '''<Summary>
            '''The booking id for the message (if connected to a booking).
            '''</Summary>
            <ApiMember(Description:="The booking id for the message (if connected to a booking).")>
            Public Overridable Property BookingId As Nullable(Of Integer)

            '''<Summary>
            '''The message receiver. Either a email or a mobile phone number.
            '''</Summary>
            <ApiMember(Description:="The message receiver. Either a email or a mobile phone number.")>
            Public Overridable Property Receiver As String

            '''<Summary>
            '''Message Title.
            '''</Summary>
            <ApiMember(Description:="Message Title.")>
            Public Overridable Property MessageTitle As String

            '''<Summary>
            '''Message Storage Url.
            '''</Summary>
            <ApiMember(Description:="Message Storage Url.")>
            Public Overridable Property StorageUrl As String

            '''<Summary>
            '''Message Body.
            '''</Summary>
            <ApiMember(Description:="Message Body.")>
            Public Overridable Property MessageBody As String

            '''<Summary>
            '''When message was created.
            '''</Summary>
            <ApiMember(Description:="When message was created.")>
            Public Overridable Property Created As Date

            '''<Summary>
            '''When the message will be sent.
            '''</Summary>
            <ApiMember(Description:="When the message will be sent.")>
            Public Overridable Property ToSendDate As Date

            '''<Summary>
            '''When the message was sent.
            '''</Summary>
            <ApiMember(Description:="When the message was sent.")>
            Public Overridable Property SentDate As Nullable(Of Date)

            '''<Summary>
            '''If Message is sent
            '''</Summary>
            <ApiMember(Description:="If Message is sent")>
            Public Overridable Property Sent As Boolean

            '''<Summary>
            '''Number of retries to send the message
            '''</Summary>
            <ApiMember(Description:="Number of retries to send the message")>
            Public Overridable Property MessageRetries As Integer

            '''<Summary>
            '''Send Method. 1 = Email, 2 = SMS
            '''</Summary>
            <ApiMember(Description:="Send Method. 1 = Email, 2 = SMS")>
            Public Overridable Property SendMethodId As Integer
        End Class

        <ApiResponse(Description:="You were unauthorized to call this service", StatusCode:=401)>
        <ValidateRequest(Validator:="IsAuthenticated")>
        Public Partial Class SendSMS
            Implements ICompany
            '''<Summary>
            '''The company id, if empty will use the company id for the user you are logged in with.
            '''</Summary>
            <ApiMember(Description:="The company id, if empty will use the company id for the user you are logged in with.")>
            Public Overridable Property CompanyId As Nullable(Of Guid)

            '''<Summary>
            '''The message receiver phone number (valid mobile number).
            '''</Summary>
            <ApiMember(Description:="The message receiver phone number (valid mobile number).")>
            Public Overridable Property Receiver As String

            '''<Summary>
            '''Message Body.
            '''</Summary>
            <ApiMember(Description:="Message Body.")>
            Public Overridable Property MessageBody As String

            '''<Summary>
            '''When the message will be sent.
            '''</Summary>
            <ApiMember(Description:="When the message will be sent.")>
            Public Overridable Property ToSendDate As Date
        End Class
    End Namespace
End Namespace

VB.NET SendSMS DTOs

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

HTTP + OTHER

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

POST /messages/sendsms HTTP/1.1 
Host: api.bokamera.se 
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length

{"CompanyId":"00000000-0000-0000-0000-000000000000","Receiver":"String","MessageBody":"String"}
HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length

{"Id":0,"BookingId":0,"Receiver":"String","MessageTitle":"String","StorageUrl":"String","MessageBody":"String","SentDate":"0001-01-01T00:00:00","Sent":false,"MessageRetries":0,"SendMethodId":0}