Pull request #14: feature/EOA-5901-SS-Intellegence-Cloud-Api

Merge in SDK/java_telesign from feature/EOA-5901-SS-Intellegence-Cloud-Api to developer

Squashed commit of the following:

commit 6f9e7a7c7c273b55ababe26a5f5a73d3d9ff2583
Author: MousumiMohanty <@telesign.com>
Date:   Mon Nov 3 18:47:23 2025 +0530

    Added support for Intelligence Cloud to use new endpoint

Author: mmohanty-telesign

RELEASE.md

@@ -1,3 +1,7 @@
+## [4.0.0](http://central.maven.org/maven2/com/telesign/telesign/4.0.0) - 2025-11-4
+- 2025-11-4
+  - Added support for Intelligence Cloud to use new endpoint.
+
 ## [3.0.1](http://central.maven.org/maven2/com/telesign/telesign/3.0.1) - 2025-09-18
 - 2025-09-18
   - Updated SDK install instructions on GitHub to default to latest version for Telesign SDK

build.gradle

@@ -9,7 +9,7 @@ plugins {
 }
 
 group 'com.telesign'
-version '3.0.1'
+version '4.0.0'
 
 sourceCompatibility = JavaVersion.VERSION_1_8
 targetCompatibility = JavaVersion.VERSION_1_8
@@ -138,7 +138,7 @@ if (System.getenv('TRAVIS') == null) {
 
                 groupId = 'com.telesign'
                 artifactId = 'telesign'
-                version = '3.0.1'
+                version = '4.0.0'
 
                 pom {
                     name = 'Telesign SDK'

src/main/java/com/telesign/ScoreClient.java

@@ -11,10 +11,12 @@
  */
 public class ScoreClient extends RestClient {
 
-    private static final String SCORE_RESOURCE = "/v1/score/%s";
+    private static final String INTELLIGENCE_SCORE_RESOURCE = "/intelligence/phone";
+
+    private static final String DETECT_REST_ENDPOINT = "https://detect.telesign.com";
 
     public ScoreClient(String customerId, String apiKey) {
-        super(customerId, apiKey);
+        super(customerId, apiKey, DETECT_REST_ENDPOINT);
     }
 
     public ScoreClient(String customerId, String apiKey, String restEndpoint, String source, String sdkVersionOrigin, String sdkVersionDependency) {
@@ -41,19 +43,18 @@ public ScoreClient(String customerId,
     }
 
     /**
-     * Score is an API that delivers reputation scoring based on phone number intelligence, traffic patterns, machine
-     * learning, and a global data consortium.
+     *Obtain a risk recommendation for this phone number, as well as other relevant information using Telesign Cloud API.
      * <p>
-     * See https://developer.telesign.com/docs/score-api for detailed API documentation.
+     * See https://developer.telesign.com/enterprise/reference/submitphonenumberforintelligencecloud for detailed API documentation.
      */
     public TelesignResponse score(String phoneNumber, String accountLifecycleEvent, Map<String, String> params) throws IOException, GeneralSecurityException {
-
         if (params == null) {
             params = new HashMap<>();
         }
-
+        
+        params.put("phone_number", phoneNumber);
         params.put("account_lifecycle_event", accountLifecycleEvent);
 
-        return this.post(String.format(SCORE_RESOURCE, phoneNumber), params);
+        return this.post(INTELLIGENCE_SCORE_RESOURCE, params);
     }
 }

src/test/java/com/telesign/ScoreClientTest.java

@@ -5,7 +5,6 @@
 import okhttp3.mockwebserver.MockWebServer;
 import okhttp3.mockwebserver.RecordedRequest;
 
-import java.text.SimpleDateFormat;
 import java.util.HashMap;
 import java.util.concurrent.TimeUnit;
 
@@ -16,14 +15,11 @@ public class ScoreClientTest extends TestCase {
     private String customerId;
     private String apiKey;
 
-    private SimpleDateFormat rfc2616 = new SimpleDateFormat("EEE, dd MMM yyyy HH:mm:ss 'GMT'");
-
-
     public void setUp() throws Exception {
         super.setUp();
 
         customerId = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890";
-        apiKey = "EXAMPLE----TE8sTgg45yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==";
+        apiKey = "ABC12345yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==";
 
         mockServer = new MockWebServer();
         mockServer.start();
@@ -40,7 +36,6 @@ public void testScoreClientConstructorMinimal() throws Exception {
         assertNotNull(client);
     }
 
-
     public void testScoreClientConstructorFull() throws Exception {
         ScoreClient client = new ScoreClient(customerId,
                 apiKey,
@@ -58,7 +53,6 @@ public void testScoreClientConstructorFull() throws Exception {
     }
 
     public void testScoreWithParams() throws Exception {
-
         HashMap<String, String> params = new HashMap<String, String>() {{
             put("originating_ip", "127.0.0.1");
             put("account_lifecycle_event", "create");
@@ -70,24 +64,25 @@ public void testScoreWithParams() throws Exception {
                 this.apiKey,
                 this.mockServer.url("").toString().replaceAll("/$", ""), null, null, null);
 
-        client.score("18005555555", "create", params);
+        client.score("11234567890", "create", params);
 
         RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
 
         assertEquals("method is not as expected", "POST", request.getMethod());
-        assertEquals("path is not as expected", "/v1/score/18005555555", request.getPath());
-        assertEquals("body is not as expected", "originating_ip=127.0.0.1&account_lifecycle_event=create",
-                request.getBody().readUtf8());
+        assertEquals("path is not as expected", "/intelligence/phone", request.getPath());
+
+        String body = request.getBody().readUtf8();
+        assertTrue("body does not contain phone_number", body.contains("phone_number=11234567890"));
+        assertTrue("body does not contain originating_ip", body.contains("originating_ip=127.0.0.1"));
+        assertTrue("body does not contain account_lifecycle_event", body.contains("account_lifecycle_event=create"));
+
         assertEquals("Content-Type header is not as expected", "application/x-www-form-urlencoded",
                 request.getHeader("Content-Type"));
         assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
                 request.getHeader("x-ts-auth-method"));
     }
 
     public void testScore() throws Exception {
-
-        HashMap<String, Object> params = new HashMap<String, Object>();
-
         this.mockServer.enqueue(new MockResponse().setBody("{}"));
 
         ScoreClient client = new ScoreClient(this.customerId,
@@ -99,15 +94,15 @@ public void testScore() throws Exception {
         RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
 
         assertEquals("method is not as expected", "POST", request.getMethod());
-        assertEquals("path is not as expected", "/v1/score/18005555555", request.getPath());
-        assertEquals("body is not as expected", "account_lifecycle_event=create",
-                request.getBody().readUtf8());
+        assertEquals("path is not as expected", "/intelligence/phone", request.getPath());
+
+        String body = request.getBody().readUtf8();
+        assertTrue("body does not contain phone_number", body.contains("phone_number=18005555555"));
+        assertTrue("body contains account_lifecycle_event", body.contains("account_lifecycle_event=create"));
+
         assertEquals("Content-Type header is not as expected", "application/x-www-form-urlencoded",
                 request.getHeader("Content-Type"));
         assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
                 request.getHeader("x-ts-auth-method"));
     }
-
-}
-
-
+}

src/test/java/com/telesign/example/score/CheckPhoneNumberRiskLevel.java

@@ -8,7 +8,7 @@ public class CheckPhoneNumberRiskLevel {
     public static void main(String[] args) {
 
         String customerId = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890";
-        String apiKey = "EXAMPLE----TE8sTgg45yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==";
+        String apiKey = "ABC12345yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==";
 
         String phoneNumber = "phone_number";
         String accountLifecycleEvent = "create";
@@ -22,6 +22,9 @@ public static void main(String[] args) {
                         phoneNumber,
                         telesignResponse.json.getAsJsonObject("risk").get("level").getAsString(),
                         telesignResponse.json.getAsJsonObject("risk").get("recommendation").getAsString()));
+            } 
+            else {
+                System.out.println("Request failed with status: " + telesignResponse.statusCode);
             }
         } catch (Exception e) {
             e.printStackTrace();