Dillo.Sms 1.4.0

Description

Use the Dillo.Sms library to create outbound SMS requests and make http requests to the Dillo API.

Installation

You can add the library to your .NET project:

1. using the NuGet Package Manager
2. using the Package Manager Console within Visual Studio IDE

Install-Package Dillo.Sms

3. using the .NET Core Command Line Tools

dotnet add package Dillo.Sms

Sample Usage

The sample code below shows you how to create an outbound SMS request.

OutboundSmsRequestBuilder smsRequestBuilder = new OutboundSmsRequestBuilder(
        sender: "Dillo",
        telephoneNumber: "+40740000000",
        message: "Hello world!"
    );

OutboundSmsRequest smsRequest = smsRequestBuilder.Build();

The resulting outbound sms request is:

{
  "SendActionType": "Sms",
  "MessagePayload": "{\"SmsSender\":\"Dillo\",\"TelephoneNumber\":\"+40740000000\",\"Message\":\"Hello world!\"}"
}

Http requests to the Dillo API

Http Client

Initialize the DilloSmsClient.

DilloSmsClient.Init("CustomerCode", "ApiKey");

Note: replace CustomerCode and *ApiKey with your own.

Http POST request

OutboundSmsPostResponse postResponse = await smsRequest.SendAsync();

Response sample:

{
  "Id": "38a3b1cd-4f44-401b-a1f4-fb289c0a607b",
  "StatusCode": 200,
  "IsSuccess": true
}

Http GET request

OutboundSmsGetResponse getResponse = await postResponse.GetAsync();

Response sample:

{
  "Result": {
    "Id": "38a3b1cd-4f44-401b-a1f4-fb289c0a607b",
    "Sender": "Dillo",
    "TelephoneNumber": "+40740000000",
    "Message": "Hello world!",
    "CreatedOnUtc": "2020-07-27T12:34:03.1061426Z",
    "UpdatedOnUtc": "2020-07-27T12:34:06.6513511Z",
    "Price": 0,
    "CustomerCode": "CustomerCode",
    "Status": {
      "PrimaryStatus": {
        "Code": 400,
        "Description": "Failed"
      },
      "SecondaryStatus": {
        "Code": 20,
        "Description": "SenderNotFound"
      },
      "StatusCode": "400.20"
    }
  },
  "StatusCode": 200,
  "IsSuccess": true
}