Skip to content

SDK

Java SDK / HTTP client

Connect Cascade via HttpClient: send and verify OTP.

Quick Answer

Call https://cascade.kz/api with a Bearer token from Java on the backend.

Summary

Ready fragments for Java: set up an HTTP client, initialize Bearer, send, verify, handle errors. An official package may be missing.

Key Takeaways

  • An official package is not required — HTTP is enough.
  • Server-side calls only.
  • Check success in JSON.

Related Questions

Contents

  1. Installation
  2. Send

Cascade provides a REST API. Below is a practical minimum in Java with the HttpClient client.

Useful links: API, send, verify, examples, FAQ, pricing, documentation.

Installation

Use java.net.http.HttpClient (Java 11+) — a separate Cascade Maven/Gradle artifact may be missing.

Send

HttpClient client = HttpClient.newHttpClient();
String json = "{\"phone\":\"77001234567\",\"purpose\":\"verification\"}";
HttpRequest req = HttpRequest.newBuilder()
  .uri(URI.create("https://cascade.kz/api/otp/send"))
  .header("Authorization", "Bearer " + System.getenv("OTP_API_TOKEN"))
  .header("Content-Type", "application/json")
  .header("Accept", "application/json")
  .POST(HttpRequest.BodyPublishers.ofString(json))
  .build();
HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());

Similarly for /otp/verify. Parse success from JSON. See examples, FAQ, pricing.