Ses dosyaları

Yükleme

• Sesli mesaj yapacağınız ses dosyasını API ile yükleyebilirsiniz.

• form-data olarak gönderim yapmalısınız.

POST https://api.netgsm.com.tr/voicesms/upload

Örnek İstek (Sample Request)

curl --location 'https://api.netgsm.com.tr/voicesms/upload' \
--form 'username="850xxxxxxx"' \
--form 'password="xxxxxxxx"' \
--form 'dosya=@"/filepath"'

Örnek Başarılı Cevap (Success Response)

12345

Örnek Hata Cevabı (Error Response)

HataKodu

** Tanımlar **

Değişken	Zorunlu	Anlamı
username	Evet	Netgsm'den hizmet alınan abone numarası (Format: 850xxxxxxx, 312XXXXXXX vs.).
password	Evet	Alt kullanıcı şifresi. (Alt kullanıcı türü "API Kullanıcısı" olan alt kullanıcıya ait şifre.)
dosya	Evet	Yüklemek istediğiniz dosya. (İzinli Uzantılar : ".wav")

** Hata Durumları **

Hata Kodu	Anlamı
10	Dosyanızın sistemimize başarılı bir şekilde alınamadığını ifade eder.
20	Geçersiz dosya uzantısını ifade eder. (İzinli Uzantılar : ".wav")
30	Geçersiz kullanıcı adı, şifre veya kullanıcınızın API erişim izninin olmadığını gösterir. Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı, web arayüzümüzden; sağ üst köşede bulunan Abonelik İşlemleri / API işlemleri menüsunden kontrol edebilirsiniz.
40	Göndermeye çalıştığınız dosya boyutunun maksimum gönderebileceğiniz dosya boyutunu aştığını ifade eder. (Maksimum dosya boyutu: 4 MB)

Listeleme

Yüklediğiniz ses dosyalarını sorgulayarak bilgisine ulaşabilirsiniz.

POST https://api.netgsm.com.tr/voicesms/uploadlist

Örnek İstek (Sample Request)

<?xml version='1.0'?>
<mainbody>
    <header>  
        <usercode>850xxxxxxx</usercode>
        <password>xxxxxxxx</password>
        <startdate>150420261200</startdate>
        <stopdate>160420261200</stopdate>
    </header>
</mainbody>

Örnek Başarılı Cevap (Success Response)

123456 | 850xxxxxxx | 16.04.2026 15:55 | 10 | url

Açıklamalar:
123456                -> AudioID
850xxxxxxx            -> Gönderen TelefonNo
16.04.2026 15:55      -> Tarih
10                    -> Mesaj Süresi
url                   -> Yüklenmiş Dosya

Örnek Hata Cevabı (Error Response)

HataKodu

** Tanımlar **

Değişken	Zorunlu	Anlamı
usercode	Evet	Netgsm'den hizmet alınan abone numarası (Format: 850xxxxxxx, 312XXXXXXX vs.).
password	Evet	Alt kullanıcı şifresi. (Alt kullanıcı türü "API Kullanıcısı" olan alt kullanıcıya ait şifre.)
startdate	Evet	İki tarih arası sorgulamanızda başlangıç tarihi. (Format: ddMMyyyyHHmm)
stopdate	Evet	İki tarih arası sorgulamanızda bitiş tarihi. (Format: ddMMyyyyHHmm)

** Hata Durumları **

Hata Kodu	Anlamı
30	Geçersiz kullanıcı adı, şifre veya kullanıcınızın API erişim izninin olmadığını gösterir. Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı, web arayüzümüzden; sağ üst köşede bulunan Abonelik İşlemleri / API işlemleri menüsunden kontrol edebilirsiniz.
40	Arama kriterlerinize göre listelenecek kayıt olmadığını ifade eder.
50	Arama kriterlerindeki tarih formatının hatalı olduğunu ifade eder. (Format: ddMMyyyyHHmm)
60	Arama kiterlerindeki startdate ve stopdate zaman farkının 30 günden fazla olduğunu ifade eder.
70	Hatalı sorgulama. Gönderdiğiniz parametrelerden birisi hatalı veya zorunlu alanlardan birinin eksik olduğunu ifade eder.