LangageGuide · SDK officiel bientôt

Envoyez des SMS en Tunisie depuis Java, sans dépendance.

Le client java.net.http, inclus dans le JDK, suffit pour appeler l’API Sendimo. Aucune librairie à ajouter dans Maven ou Gradle. Le SDK Java officiel arrive.

Ce que ça fait

Uniquement le JDK (Java 17 ou plus récent pour les text blocks).
Délais d’attente configurables sur chaque requête.
Réponse JSON facile à lire avec Jackson ou Gson.
Fonctionne dans toute application JVM : Jakarta EE, Quarkus, Micronaut…

Mise en place

1Utilisez Java 17 ou plus récent.
2Ajoutez votre clé API dans la variable d’environnement SENDIMO_API_KEY.
3Envoyez un POST sur /v1/messages avec HttpClient.
4Recevez les statuts de livraison par webhook.

Envoyer un SMSJava

// Java 17+ (java.net.http, no dependency)
HttpClient client = HttpClient.newHttpClient();

String body = """
    {
      "to": "+21620123456",
      "from": "SENDIMO",
      "text": "Votre code est 482913. Il expire dans 5 minutes.",
      "reference": "order-4821"
    }
    """;

HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.sendimo.tn/v1/messages"))
    .header("Authorization", "Bearer " + System.getenv("SENDIMO_API_KEY"))
    .header("Content-Type", "application/json")
    .header("Idempotency-Key", "order-4821-otp")
    .timeout(Duration.ofSeconds(10))
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode()); // 202
System.out.println(response.body());       // {"id":"msg_01HF8Z3K9QX2","status":"queued",...}

Réponse 202 AcceptedJSON

{
  "id": "msg_01HF8Z3K9QX2",
  "status": "queued",
  "to": "+21620123456",
  "from": "SENDIMO",
  "text": "Votre code est 482913. Il expire dans 5 minutes.",
  "encoding": "GSM-7",
  "segments": 1,
  "network": "ooredoo",
  "cost": { "amount": "0.140", "currency": "TND" },
  "reference": "order-4821",
  "scheduled_at": null,
  "created_at": "2026-10-30T09:15:00Z"
}