v4.0.0-beta.1

Note: This is a snapshot of the upcoming v4.0.0 of the library. Things may change.

Added

• Added Ncco class to wrap Collection<Action> and handle the serialization of NCCO json through toJson.
• Added the following Builder classes:
  • ConnectAction.Builder
  • ConversationAction.Builder
  • InputAction.Builder
  • RecordAction.Builder
  • StreamAction.Builder
  • TalkAction.Builder
• Added PhoneEndpoint to com.nexmo.voice.ncco package for use with ConnectAction.
• Added WebSocketEndpoint to com.nexmo.voice.ncco package for use with ConnectAction.
• Added SipEndpoint to com.nexmo.voice.ncco package for use with ConnectAction.
• Added EventMethod enumeration to replace the usage of strings.
• Added EventType enumeration and the ability to specify the eventType property of ConnectAction.

Changed

• Renamed all Ncco classes to Action classes:
  • Renamed Ncco interface to Action
  • Renamed ConnectNcco to ConnectAction
  • Renamed ConversationNcco to ConversationAction
  • Renamed InputNcco to InputAction
  • Renamed RecordNcco to RecordAction
  • Renamed StreamNcco to StreamAction
  • Renamed TalkNcco to TalkAction
• All Action classes now must be constructed through the provided Builder class.
• All Action classes are now immutable.
• The eventUrl property of ConnectAction, ConversationAction, InputAction, and RecordAction is now a Collection<String> instead of an array.
• The eventMethod property of ConnectAction, ConversationAction, InputAction, and RecordAction is now an EventMethod enum instead of a String.

v3.8.0

Added

• Added com.nexmo.client.incoming.MessageEvent to assist with the deserialization of the JSON payload used for incoming messages.
• Added com.nexmo.client.incoming.CallEvent to assist with the deserialization of the JSON payload used for call events.
• Added com.nexmo.client.incoming.InputEvent to assist with the deserialization of the JSON payload used for input events.
• Added com.nexmo.client.incoming.RecordEvent to assist with the deserialization of the JSON payload used for record events.
• Added secret management methods to AccountClient in the form of the following methods:
  • listSecrets for listing all secrets.
  • getSecret for getting information on a specific secret.
  • revokeSecret for revoking a secret.
  • createSecret for creating a new secret.

Changed

• User Agent String now includes the Java version in addition to the client version.
• enum classes that are used to deserialize JSON have been updated to return an UNKNOWN value instead of throwing an IllegalArgumentException when the value cannot be deserialized. These enums are:
  • RecordingFormat
  • MachineDetection
  • ModifyCallAction
  • CallDirection
  • CallStatus
  • RoamingDetails.RoamingStatus
  • AdvancedInsightResponse.PortedStatus
  • AdvancedInsightResponse.Validity
  • AdvancedInsightResponse.Reachability

Fixed

• Updated StreamNcco's streamUrl to serialize into an array for use in the Voice API.

v3.7.0

Added

• Added RedactClient and the ability to interact with the Nexmo Redact API.

Changed

• TalkNcco now uses VoiceName internally instead of String for the voiceName property.

v3.6.0

Added

• Added getSmsPrice to AccountClient for getting SMS pricing for a country.
• Added getVoicePrice to AccountClient for getting voice pricing for a country.
• Added getPrefixPrice to AccountClient for getting SMS and voice pricing for a prefix.
• Added topUp to AccountClient for topping up your account which has auto-reload enabled.
• Added getSms to SmsClient for searching for a single message by id.
• Added ConversionClient and the ability to interact with the Nexmo Conversion API.

v3.5.0

Changed

• Updated VerifyClient to use the JSON endpoints instead of XML.

• Updated endpoints which are used by VerifyClient from public to package scope in order to encourage usage through VerifyClient.

• Deprecated XML version of the following endpoints:

  • VerifyEndpoint
  • CheckEndpoint
  • SearchEndpoint

• Deprecated the following XML results:

  • VerifyResult should use VerifyResponse
  • CheckResult should use CheckResponse
  • SearchResult should use SearchVerifyResponse

• Deprecated the following XML methods:

  • VerifyCheckMethod

Added

• Added VerifyStatus enumeration to use for statuses coming back from the verify endpoint.
• Added VerifyResponse, CheckResponse, and SearchVerifyResponse for JSON responses to match other JSON using endpoints.
• Added VerifyMethod, CheckMethod, and SearchMethod for better segregation between endpoint and method classes.
• Add split attribute to the RecordNcco object.

Fixed

• Updated ConversationNcco's musicOnHoldUrl to serialize into an array for use in the Voice API.

v3.4.1

Changed

• Updated Jackson Databind dependency to newer version.

v3.4.0

Changed

• Modify call now works with the API again, returning null (because the API now returns 204 No Content)
• VerifyRequest now supports all supported parameters.
• Client-side validation for the from parameter's length on the Message class has been removed.

Added

• Add level attribute to the TalkNcco object.

v3.3.0

• Modify call now works with the API again, returning null (because the API now returns 204 No Content)
• VerifyRequest now supports all supported parameters.

v3.2.0

Changed

Adds signature authentication to the endpoints which support it.

v3.1.0

Added

• Add NexmoClient.generateJwt
• Add VoiceClient.downloadRecording

Changed

• Made exceptions from AuthCollection's getAuth and getAcceptableAuthMethod more specific. (Backwards compatible change)