Releases: Vonage/vonage-dotnet-sdk
v5.6.2
New, simplified method for sending SMS messages.
To send an SMS simply use the Sms client's SendAnSms
function
var smsResponse = smsClient.SendAnSms(FROM_NUMBER, TO_NUMBER, TEXT);
Also first auto-released Vonage .NET SDK
v5.6.1
New, simplified method for sending SMS messages.
To send an SMS simply use the Sms client's SendAnSms
function
var smsResponse = smsClient.SendAnSms(FROM_NUMBER, TO_NUMBER, TEXT);
Also first auto-released Vonage .NET SDK
v5.6.0
New, simplified method for sending SMS messages.
To send an SMS simply use the Sms client's SendAnSms
function
var smsResponse = smsClient.SendAnSms(FROM_NUMBER, TO_NUMBER, TEXT);
v5.5.0
New
- Voice Talk Command and Talk NCCO now allow you to use the
language
andstyle
parameters for text-to-speech. E.g.
var talkAction = new TalkAction() { Text = "Hei dette er en tekst-til-tale-samtale fra vonage " + extraText, Language="no-NO" };
Deprecations
- The
VoiceName
parameter has been deprecated.
v5.4.0
New
- Adds the Async Pattern to the Vonage SDK. All methods that were synchronous have both a sync and async flavor. To use the async method simply add
Async
to the end of the old method name - e.g.SendAnSmsAsync
- Adds new APIs for making Phone calls with the Voice API, specifically
CreateCall
has two new overloads which support either two phone numbers (to and from) and an NCCO, or a to endpoint and from number and NCCO
Fixes
- Fix enumeration issue for Verify workflows
- Some minor null checking.
v5.3.0
5.3.0 switches all naming in the SDK from Nexmo -> Vonage. And marks the first release of the new Vonage nuget package.
The Nexmo namespace is preserved but all classes within it are marked as deprecated as they will be removed in the next major release (6.0).
v5.2.0
Adds new utility methods for parsing inbound webhooks from Vonage
Fixes bug with parsing multi-input event webhooks.
v5.1.0
New
This new version of the .NET Nexmo SDK Introduces the new PSD2 feature for the Vonage Verify API.
For more details about using this feature see its code snippets. And its API Reference
v5.0.0
New Features
We've added a few new features to the .NET SDK, here's an enumeration of them.
Rebuilt SDK Around .NET Conventions
Older iterations of the SDK didn't feel very ".NET", this release fixes that.
-
We've abstracted all API Calls behind interfaces allowing easy substitution via dependency injection for your testing. For example, the Legacy SDKs SMS class is replaced by the
ISmsClient
interface, which you can speak through or replace on your own. -
All of the new structures and APIs are now compliant with .NET naming conventions. Additionally, we've introduced many new enums to remove some open string fields. We preserved the legacy structures but marked them as obsolete as a gentle reminder to update the latest version as this will make upgrading easier.
New Logging Methodology
A new means of logging has been added to the SDK built around Microsoft.Extensions.Logging. Thus you can configure the logging of the SDK to use whatever logging format you want; you can make it as compliant to your own logs as you'd like, and there's no need to log our SDKs outputs to your log files. See my explainer about how this is structured and how you can get up and logging with your own logs!
Added Summary Documentation File
The SDK now comes with a summary docs file to make it easier for you to determine how to go about building your applications.
New Error Handling Methodology
All API calls will throw an exception containing a best-effort description of what went wrong if they encounter an error. This includes all 4xx, 5xx responses, and errors from the SMS, Numbers, Number Insight, and Verify APIs that might respond with a 200 OK response and an error code. All of these exceptions will be of the type NexmoException
(SubTypes NexmoSmsResponseException
, NexmoNumberInsightResponseException
, NexmoNumberResponseException
, NexmoVerifyResponseException
) or NexmoHttpRequestException
.
There are similar errors that will be thrown for the legacy APIs as well.
Under the Hood
We've also made some significant enhancements under the hood that will be less relevant to interacting with the API but might still be interesting.
Refactored Internal Request Methods
We've refactored all of the internal ApiRequest
methods to make them more user friendly and generic. You can have a look here.
Note: These methods are not considered part of the public API of the SDK and are subject to change without notice.
Unit Tests
We've added a whole new suite of unit tests to prevent things from breaking on their way out the door. Unit test coverage went from 33% in 4.4.0 to 87% in 5.0. Virtually everything that is not tested is either legacy or a third party file previously incorporated into the SDK.
Breaking Changes
We've done our best to ensure that the upgrade path to 5.0 will be as seamless as possible. The new structures should not affect current users of the SDK though I would encourage everyone to heed the obsolescence warnings. That said, there are a couple of breaking changes between 4.x and 5.x that you should be aware of.
-
We've removed LibLog, thus without action on the developer's part logs will cease to be intermingled with developer's logs.
-
New exceptions will be thrown in the case of any error being encountered on an API call, this includes 200 responses with error codes.
If anyone encounters any issues please open an issue in the Github repo
v4.4.1
Fixes
- Changes the encoding of JSON payloads from ASCII to UTF8