Postman ile KobiKom SMS API Testi:
Adım Adım Rehber

1Postman'ı İndirin ve Kurun

postman.com/downloads adresinden işletim sisteminize uygun sürümü indirin (Windows, macOS, Linux). Kurulumdan sonra ücretsiz hesap oluşturun — bu koleksiyon paylaşımı için gereklidir.

2Environment Variable Tanımlayın

API anahtarını her istekte elle yazmak yerine Postman Environment Variable kullanın. Bu hem güvenlidir hem de sonradan değiştirmek kolaylaşır.

3İlk API İsteğini Gönderin

Yeni bir Collection oluşturun ve içine POST isteği ekleyin. Authorization sekmesinde Bearer Token seçip değer alanına {{api_key}} yazın.

{
  "to": "{{test_phone}}",
  "message": "KobiKom Postman testi — merhaba!",
  "sender": "{{sender_id}}"
}

Send butonuna tıklayın. Başarılı yanıt şöyle görünmeli:

{
  "success": true,
  "messageId": "msg_test_abc123",
  "to": "+905XXXXXXXXX",
  "status": "queued",
  "sender": "KOBIKOM",
  "creditUsed": 1,
  "creditRemaining": 9999,
  "createdAt": "2026-03-24T10:30:00Z"
}

4Toplu SMS Gönderimi

Koleksiyona yeni bir POST isteği ekleyin. Bulk endpoint ile aynı anda birden fazla alıcıya mesaj gönderebilirsiniz.

{
  "recipients": [
    "+905551234567",
    "+905559876543",
    "+905553334444"
  ],
  "message": "Merhaba! %30 indirim fırsatı sizi bekliyor. kobikom.com.tr",
  "sender": "{{sender_id}}",
  "campaignName": "Postman-Test-Mart2026"
}

{
  "success": true,
  "batchId": "batch_xk9p2mq7r",
  "totalRecipients": 3,
  "queued": 3,
  "filtered": 0,
  "estimatedDelivery": "~5 saniye",
  "creditUsed": 3,
  "creditRemaining": 9997,
  "campaignName": "Postman-Test-Mart2026",
  "createdAt": "2026-03-24T10:30:00Z"
}

5OTP SMS Testi

Doğrulama kodu senaryolarını test etmek için OTP endpoint'ini kullanın. API, belirtilen uzunlukta otomatik kod üretir ve şablondaki {{code}} yerine yerleştirir.

{
  "to": "{{test_phone}}",
  "template": "Doğrulama kodunuz: {{code}}. Kod 5 dakika geçerlidir. KobiKom",
  "codeLength": 6,
  "expireMinutes": 5
}

{
  "success": true,
  "otpId": "otp_7gf3hqw1x",
  "to": "+905XXXXXXXXX",
  "expireAt": "2026-03-24T10:35:00Z",
  "expireMinutes": 5,
  "creditUsed": 1,
  "createdAt": "2026-03-24T10:30:00Z"
}

6SMS Durumu Sorgulama

Gönderilen SMS'in teslim edilip edilmediğini sorgulamak için GET isteği kullanın. messageId değerini önceki yanıttan alın.

{
  "messageId": "msg_test_abc123",
  "to": "+905XXXXXXXXX",
  "status": "delivered",
  "deliveredAt": "2026-03-24T10:30:04Z",
  "operator": "Turkcell",
  "creditUsed": 1
}

7Koleksiyonu Kaydedin ve Paylaşın

Tüm istekleri bir koleksiyon altında topladıktan sonra ekibinizle paylaşabilirsiniz. Postman'da koleksiyonu dışa aktararak JSON formatında kaydedin veya Postman workspace'e yükleyin.

8Üretim Geçişi İpuçları

Postman testleri başarılı geçtikten sonra gerçek entegrasyona geçerken dikkat edilmesi gereken noktalar: