Faks gönderme

• İstediğiniz faks numarasına belirleyeceğiniz zaman aralıklarıyla faks gönderilmesi işlemidir.

• Her Referans Id yalnızca bir defa kullanılabilir. Aynı dosyayı birden fazla kişiye göndermek için telefon parametresinde birden fazla telefon numarası belirtebilirsiniz.

• startdate ve stopdate parametrelerinin birlikte kullanılması gerekmektedir. Parametreler gönderilmezse gönderim hemen başlar.

POST https://api.netgsm.com.tr/fax/send

Örnek İstek (Sample Request)

curl --location 'https://api.netgsm.com.tr/fax/send' \
--header 'Content-Type: multipart/form-data' \
--form 'username="850xxxxxxx"' \
--form 'password="xxxxxxxx"' \
--form 'refid="123"' \
--form 'telefon="850xxxxxxx"' \
--form 'parametre="2"'

Ö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.)
refid	Evet	Faks dosyası yüklerken belirlediğiniz referans numarasıdır.
telefon	Evet	Faks göndereceğiniz telefon numarası. (Örnek: 3129110911) Eğer birden fazla telefon numarasına gönderim yapmak istiyorsanız; (3129110911,3129110912,3129110913) telefon numalarının arasına virgül ekleyerek gönderiniz.
parametre	Evet	Faks gönderme işlemi için; 2 değerini almalıdır.
startdate	Opsiyonel	Faks göndermeye başlayacağınız tarih. (Format: ddmmyyyyhhmm) * stopdate parametresi ile birlikte kullanılır, gönderilmezse mesajınız hemen gider.
stopdate	Opsiyonel	İki tarih arası gönderimlerinizde bitiş tarihi (Format: ddmmyyyyhhmm) * startdate parametresi ile birlikte kullanılır, gönderilmezse faksınızın gönderim bitiş zamanı sistem tarafından belirlenir.

** Servisten Alınan Örnek Cevap **

Kodu	Anlamı
12345	Fax GörevId

** Hata Durumları **

Hata Kodu	Anlamı
10	Dosyanın kopyalanamadığını ifade eder.
20	Geçersiz dosya uzantısını ifade eder. (İzin verilen dosya uzantıları: .jpeg, .jpg, .png, .gif, .pdf, .doc, .docx, .xls, .xlsx)
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: 8 MB)
50	Referans Id'nin hatalı olduğunu ifade eder.
60	Başlangıç veya bitiş tarihinin hatalı olduğunu ifade eder. (Format: ddmmyyyyhhmm)
70	Gönderdiğiniz telefon numarasının hatalı olduğunu ifade eder.
80	Yetersiz kredi olduğunu ifade eder.
90	Dosyanın fax formatına çevrilemediğini ifade eder.
100	Parametrelerinizden birinde hata olduğunu ifade eder.