Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/iletimerkezi/iletimerkezi-java


https://github.com/iletimerkezi/iletimerkezi-java

Last synced: about 17 hours ago
JSON representation

Awesome Lists containing this project

README

        

# İ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

```xml

com.iletimerkezi
iletimerkezi-java
1.0.0

```

### Gradle ile Kurulum

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

## Kullanım

### Client Oluşturma

```java
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

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

// Çoklu alıcıya SMS gönderme
List 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

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

### Bakiye Sorgulama

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

### Webhook İşleme

```java
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

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

## Hata Yönetimi

```java
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

```bash
mvn clean package
```

## Lisans

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

## Destek

Herhangi bir sorunuz veya sorununuz olduğunda:

- [GitHub Issues](https://github.com/iletimerkezi/iletimerkezi-java/issues)
- E-posta: [email protected]

## Güvenlik

Güvenlik açığı bildirimi için lütfen [email protected] adresine e-posta gönderin.