İleti Merkezi Java SDK

İleti Merkezi SMS API'sini Java uygulamalarınızda kullanmanızı sağlayan resmi SDK.

Gereksinimler

• Java 11 veya üzeri
• Maven 3.6 veya üzeri

Kurulum

Maven ile Kurulum

<dependency>
    <groupId>com.iletimerkezi</groupId>
    <artifactId>iletimerkezi-java</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle ile Kurulum

implementation 'com.iletimerkezi:iletimerkezi-java:1.0.0'

Kullanım

Client Oluşturma

import com.iletimerkezi.IletiMerkeziClient;

IletiMerkeziClient client = new IletiMerkeziClient(
    "API_KEY", // API Anahtarı
    "API_HASH", // API Hash
    "SENDER" // Varsayılan Gönderici Adı
);

SMS Gönderme

// Tek alıcıya SMS gönderme
client.sms().send("+90532123xxxx", "Merhaba Dünya!");

// Çoklu alıcıya SMS gönderme
List<String> recipients = Arrays.asList(
    "+90532123xxxx",
    "+90537123xxxx"
);

client.sms().send(recipients, "Merhaba Dünya!");

// İleri tarihli SMS gönderme
client.sms()
    .schedule("2024-12-31 23:59:59")
    .send("+90532123xxxx", "Yeni Yıl Mesajı");

Rapor Sorgulama

// Özet rapor alma
client.summary().list("2024-01-01", "2024-01-31");
// Sonraki sayfa
client.summary().next();
.next();

Bakiye Sorgulama

AccountResponse response = client.account().balance();
System.out.println("Bakiye: " + response.getAmount());
System.out.println("SMS Kredisi: " + response.getCredits());

Webhook İşleme

String webhookData = "..."; // POST ile gelen veri

WebhookReport report = client.webhook().process(webhookData);
if (report.isDelivered()) {
    System.out.println("SMS iletildi: " + report.getTo());
}

Kara Liste İşlemleri

// Numara ekleme
client.blacklist().add("+90532123xxxx");
// Numara çıkarma
client.blacklist().remove("+90532123xxxx");
// Liste sorgulama
client.blacklist().list(1);

Hata Yönetimi

try {
    client.sms().send("+90532123xxxx", "Test mesajı");
} catch (IOException e) {
    // Ağ hatası
    System.err.println("Ağ hatası: " + e.getMessage());
} catch (Exception e) {
    // Diğer hatalar
System.err.println("Hata: " + e.getMessage());
}

Desteklenen Java Versiyonları

• Java 11 (LTS)
• Java 17 (LTS)
• Java 21 (LTS)

Geliştirme

Projeyi Build Etme

mvn clean package

Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakınız.

Destek

Herhangi bir sorunuz veya sorununuz olduğunda:

• GitHub Issues
• E-posta: destek@iletimerkezi.com

Güvenlik

Güvenlik açığı bildirimi için lütfen destek@iletimerkezi.com adresine e-posta gönderin.