Postman ile toplu SMS gönderin: kod yazmadan API testi
1-N ve N-N gönderim, gönderici adı, bakiye ve rapor uçlarını Postman ile dakikalar içinde deneyin. Gerekenler: ücretsiz üyelik, panelden api_id ve api_key, onaylı gönderici adı ya da 850'li numaranız.
Dört adımda ilk test mesajı
Aynı mesajı bir ya da birden çok numaraya gönderen 1-N ucuyla başlayın.
Method: POST
Postman'de yeni istek açın, method olarak POST seçin.
Adres
https://api.toplusmspaketleri.com/api/v1/1toN
Body: raw, JSON
Aşağıdaki gövdeyi yapıştırın; api_id, api_key, sender ve numaraları kendi bilgilerinizle değiştirin.
Send
200 yanıtı ve report_id dönerse mesaj gönderildi; raporu report uçlarından sorgulayın.
İstek gövdesi (1-N)
{
"api_id": "API_ID",
"api_key": "API_KEY",
"sender": "SMSBASLIGINIZ",
"message_type": "normal",
"message": "Bu bir test mesajıdır.",
"message_content_type": "bilgi",
"phones": ["5XXXXXXXXX", "5XXXXXXXXX"]
}
Türkçe karakter için message_type değerini turkce yapın. İleri tarihli gönderim için "send_time": "2026-11-01 10:00:00" ekleyin; hemen gönderim için bu alanı yazmayın. Ticari içerik için message_content_type değerini ticari gönderin.
Postman'de görünüm
Dönen kodlar ne anlama gelir?
| Kod | Anlamı |
|---|---|
200 | SMS gönderimi başarıyla tamamlandı; yanıtta report_id döner. |
401 | Geçersiz api bilgileri: api_id ya da api_key hatalı. |
422 | Onaysız ya da yanlış gönderici adı, eksik alan, biçim hatası (ör. send_time Y-m-d H:i:s değil). |
404 | Rapor bulunamadı (rapor uçlarında yanlış report_id). |
Her numaraya farklı mesaj
{
"api_id": "API_ID",
"api_key": "API_KEY",
"sender": "SMSBASLIGINIZ",
"message_type": "turkce",
"message_content_type": "bilgi",
"phones": [
{ "phone": "5XXXXXXXXX", "message": "Sayın Ayşe Yılmaz, siparişiniz kargoya verildi." },
{ "phone": "5XXXXXXXXX", "message": "Sayın Ali Kaya, randevunuz yarın 14:00." }
]
}
Adres: https://api.toplusmspaketleri.com/api/v1/NtoN. Kişiye özel hitap, doğrulama kodu ve tutar gibi alanlar her mesajda farklı olabilir.
Aynı yöntemle test edilir: POST, raw JSON
Her istekte api_id ve api_key gövdede; taban adres https://api.toplusmspaketleri.com.
| İşlem | Uç | Gövde notu |
|---|---|---|
| N-N gönderim | /api/v1/NtoN | phones dizisinde her öğe phone + message |
| Gönderici adları | /api/v1/senders | yalnız api_id ve api_key |
| Hesap bilgisi ve bakiye | /api/v1/user/information | yalnız api_id ve api_key |
| Rapor detayı | /api/v1/report/detail?page=1&pageSize=20 | report_id gövdede; pageSize 1-100 |
| Tarih aralığı raporu | /api/v1/report/between | start_date ve end_date, Y-m-d H:i:s |
| Sonuç sorgusu | /api/v1/report/single | report_id gövdede |
| İleri tarihli iptal | /api/v1/cancel/future-sms | id (rapor id) gövdede |
PHP, Python, JavaScript, Java ve C# için aynı uçların hazır kodu.
Ücretsiz hesapla test edin
Demo hesapta 10 kredi tanımlanır; api_id ve api_key panelde hazır.