Simply ConnectPrzejdź do panelu
IntegracjeJava

Java bez Springa · v0.1.0

Simply Connect
dla Javy.

Dodajesz jeden niewielki moduł JVM i korzystasz z typowanego klienta bez uruchamiania frameworka ani pisania własnej warstwy HTTP.

Pobierz wydanie v0.1.0 Pokaż instrukcję
Gotowa integracja · v0.1.0

Dla kogo jest ta integracja

Najpierw sprawdź, czy to rozwiązanie dla Ciebie.

Dla aplikacji i workerów napisanych w czystej Javie 17+, które nie używają Spring Boot. Jeżeli masz Spring Boot, wybierz osobny poradnik startera.

Co dostajesz

Mniej ręcznej pracy.
Więcej pewności.

01

Klient bez zależności od Springa

02

SMS-y i lista dostępnych bramek

03

Historia wiadomości i dostarczenia

04

Flow IVR i kolejka połączeń

05

Jawne wyniki UNKNOWN bez automatycznych powtórek

Instalacja krok po kroku

Bez zgadywania. Zrobisz to po kolei.

Każdy krok mówi, gdzie wejść i czego oczekiwać. Najpierw uruchom podstawową wysyłkę, dopiero potem włącz kolejne automatyzacje.

  1. 1

    Dodaj JitPack do Gradle

    W pliku settings.gradle dodaj JitPack obok Maven Central. Pobieranie oficjalnego wydania nie wymaga konta ani tokenu GitHub.

    dependencyResolutionManagement {
    repositories {
        mavenCentral()
        maven { url = uri("https://jitpack.io") }
    }
}
  2. 2

    Zainstaluj moduł Java

    Dodaj moduł simply-connect-java. Nie instaluj startera, jeżeli aplikacja nie korzysta ze Spring Boot.

    implementation("com.github.karlos1998.simply-connect-jvm:simply-connect-java:v0.1.0")
  3. 3

    Utwórz klucz API

    W panelu Simply Connect otwórz Developer → API keys. Do wysyłki SMS wystarczy SMS_SEND; historia wymaga MESSAGES_READ, a kolejka połączeń CALL_QUEUE_READ i CALL_QUEUE_WRITE.

    Otwórz panel Simply Connect
  4. 4

    Dodaj sekrety do środowiska

    Klucz oraz UUID bramki trzymaj poza repozytorium. Klient może też pobrać listę endpointów dostępnych dla klucza.

    SIMPLY_CONNECT_API_KEY=msc_live_twoj_sekret
SIMPLY_CONNECT_SMS_ENDPOINT_ID=uuid_twojej_bramki
  5. 5

    Utwórz klienta i wyślij SMS

    Utwórz jedną instancję klienta i przekaż biznesowy klucz idempotencji. Operacje zmieniające stan nie są automatycznie ponawiane.

    var client = SimplyConnectClient.builder()
    .apiKey(System.getenv("SIMPLY_CONNECT_API_KEY"))
    .defaultSmsEndpointId(UUID.fromString(
        System.getenv("SIMPLY_CONNECT_SMS_ENDPOINT_ID")
    ))
    .build();

var result = client.sendSms(
    "+48500100200",
    "Twoje zamówienie jest gotowe.",
    "order-1842-ready"
);

Test po instalacji

Po czym poznasz, że wszystko działa?

Nie zaczynaj od masowej wysyłki. Przejdź tę krótką listę na jednym kontrolowanym numerze.

  1. 1Projekt uruchamia się bez zależności Springa.
  2. 2Lista endpointów pokazuje tylko bramki przypisane do klucza.
  3. 3Kontrolny SMS zwraca identyfikatory i status QUEUED.
  4. 4Wiadomość pojawia się w Simply Connect i wychodzi wybraną bramką.

Gdy coś nie ruszy

Najczęstsze problemy

Najpierw sprawdź poniższe rzeczy — zwykle rozwiązanie jest tutaj.

Gradle nie znajduje artefaktu

Sprawdź, czy JitPack jest w dependencyResolutionManagement oraz czy wersja ma prefiks v, np. v0.1.0. Maven Central sam nie zawiera tej paczki.

Czy potrzebuję Spring Boot?

Nie. Ten poradnik dotyczy czystej Javy. Dla Spring Boot użyj osobnego startera, który dostarcza auto-konfigurację i opcjonalny panel.

Wysyłka zakończyła się jako UNKNOWN

Nie twórz nowej wiadomości. Sprawdź stan i ponów tylko tę samą operację z tym samym kluczem idempotencji.

Gotowe do uruchomienia

Połącz Javę z własnym numerem.

Integracja jest otwarta i wersjonowana. Kod możesz sprawdzić przed instalacją, a w razie pytania napisać do nas.

Nazwy i znaki należą do ich właścicieli. Integracja nie oznacza partnerstwa ani certyfikacji przez właściciela danego narzędzia.
Pobierz wydanie v0.1.0 Zobacz kod na GitHubiePotrzebujesz pomocy?