docs: Deprecate Verify v1, NV & SIM Swap

Author: SMadani

CHANGELOG.md

@@ -2,6 +2,9 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+# [9.3.1] - 2025-0?-??
+- Deprecated Verify v1, SIM Swap and Number Verification APIs
+
 # [9.3.0] - 2025-05-07
 - Added support for native failover in Messages API
 

README.md

@@ -74,7 +74,7 @@ Add the following to your `build.gradle` or `build.gradle.kts` file:
 
 ```groovy
 dependencies {
-    implementation("com.vonage:server-sdk:9.3.0")
+    implementation("com.vonage:server-sdk:9.3.1")
 }
 ```
 
@@ -85,7 +85,7 @@ Add the following to the `<dependencies>` section of your `pom.xml` file:
 <dependency>
     <groupId>com.vonage</groupId>
     <artifactId>server-sdk</artifactId>
-    <version>9.3.0</version>
+    <version>9.3.1</version>
 </dependency>
 ```
 

pom.xml

@@ -5,7 +5,7 @@
 
   <groupId>com.vonage</groupId>
   <artifactId>server-sdk</artifactId>
-  <version>9.3.0</version>
+  <version>9.3.1</version>
 
   <name>Vonage Java Server SDK</name>
   <description>Java client for Vonage APIs</description>

src/main/java/com/vonage/client/HttpWrapper.java

@@ -37,7 +37,7 @@
 public class HttpWrapper {
     private static final String
             CLIENT_NAME = "vonage-java-sdk",
-            CLIENT_VERSION = "9.3.0",
+            CLIENT_VERSION = "9.3.1",
             JAVA_VERSION = System.getProperty("java.version"),
             USER_AGENT = String.format("%s/%s java/%s", CLIENT_NAME, CLIENT_VERSION, JAVA_VERSION);
 

src/main/java/com/vonage/client/VonageClient.java

@@ -162,7 +162,10 @@ public SmsClient getSmsClient() {
      * Returns the Verify v1 API client.
      *
      * @return The {@linkplain VerifyClient}.
+     *
+     * @deprecated Please migrate to using {@linkplain #getVerify2Client()} instead.
      */
+    @Deprecated
     public VerifyClient getVerifyClient() {
         return verify;
     }
@@ -259,7 +262,10 @@ public ConversationsClient getConversationsClient() {
      *
      * @return The {@linkplain SimSwapClient}.
      * @since 8.8.0
+     *
+     * @deprecated This API will be removed in the next major release.
      */
+    @Deprecated
     public SimSwapClient getSimSwapClient() {
         return simSwap;
     }
@@ -269,7 +275,10 @@ public SimSwapClient getSimSwapClient() {
      *
      * @return The {@linkplain NumberVerificationClient}.
      * @since 8.9.0
+     *
+     * @deprecated This API will be removed in the next major release.
      */
+    @Deprecated
     public NumberVerificationClient getNumberVerificationClient() {
         return numberVerification;
     }

src/main/java/com/vonage/client/camara/numberverification/NumberVerificationClient.java

@@ -31,7 +31,10 @@
 /**
  * A client for communicating with the Vonage Number Verification API. The standard way to obtain an instance
  * of this class is to use {@link VonageClient#getNumberVerificationClient()}.
+ *
+ * @deprecated This API will be removed in the next major release.
  */
+@Deprecated
 public class NumberVerificationClient extends NetworkApiClient {
     final RestEndpoint<VerifyNumberRequest, VerifyNumberResponse> verifyNumber;
     private final UUID appId;

src/main/java/com/vonage/client/camara/numberverification/package-info.java

@@ -22,4 +22,5 @@
  *
  * @since 8.9.0
  */
+@Deprecated
 package com.vonage.client.camara.numberverification;

src/main/java/com/vonage/client/camara/package-info.java

@@ -20,4 +20,5 @@
  *
  * @since 8.8.0
  */
+@Deprecated
 package com.vonage.client.camara;

src/main/java/com/vonage/client/camara/simswap/SimSwapClient.java

@@ -32,7 +32,10 @@
 /**
  * A client for communicating with the Vonage SIM Swap API. The standard way to obtain an instance
  * of this class is to use {@link VonageClient#getSimSwapClient()}.
+ *
+ * @deprecated This API will be removed in the next major release.
  */
+@Deprecated
 public class SimSwapClient extends NetworkApiClient {
     final RestEndpoint<SimSwapRequest, CheckSimSwapResponse> check;
     final RestEndpoint<SimSwapRequest, SimSwapDateResponse> retrieveDate;

src/main/java/com/vonage/client/camara/simswap/package-info.java

@@ -22,4 +22,5 @@
  *
  * @since 8.8.0
  */
+@Deprecated
 package com.vonage.client.camara.simswap;

src/main/java/com/vonage/client/conversations/package-info.java

@@ -13,8 +13,11 @@
  *   See the License for the specific language governing permissions and
  *   limitations under the License.
  */
+
 /**
- * Implementation of the <a href=https://developer.vonage.com/en/conversation/overview>Conversation API</a>.
+ * Implementation of the <a href=https://developer.vonage.com/en/api/conversation>Conversation API</a>.
+ * See the <a href=https://developer.vonage.com/en/conversation/overview>Vonage developer portal</a>
+ * for an overview and documentation.
  *
  * @since 8.4.0
  */

src/main/java/com/vonage/client/verify/VerifyClient.java

@@ -29,7 +29,10 @@
  * <p>
  * More information on method parameters can be found on the
  * <a href="https://developer.vonage.com/verify/overview">Vonage developer portal</a>.
+ *
+ * @deprecated Please migrate to {@link com.vonage.client.verify2}.
  */
+@Deprecated
 public class VerifyClient {
     final RestEndpoint<CheckRequest, CheckResponse> check;
     final RestEndpoint<VerifyRequest, VerifyResponse> verify;

src/main/java/com/vonage/client/verify/package-info.java

@@ -19,4 +19,5 @@
  * See the <a href=https://developer.vonage.com/en/verify/verify-v1/overview>Vonage developer portal</a>
  * for an overview and documentation.
  */
+@Deprecated
 package com.vonage.client.verify;