API kullanarak nasıl faks gönderebilirim?

Güncellenme 29 Eylül 2026 20:12

Bu özelliği kimler kullanabilir?

Enterprise planında kullanılabilir.

Tüm üyeler.

API ile faks göndermek için önce gerekli dosyalarınızı yüklemeniz, ardından bu dosyaları fakslamaya hazırlayıp iletimlerini zamanlamanız gerekir.

Faksınız zamanlandıktan sonra bir HTTP sunucusu kurabilir ve webhook mekanizmasından yararlanabilirsiniz. Bu yaklaşım, faks iletimi başarılı olduğunda da iletim başarısız olduğunda da bir HTTP mesajının gönderilmesini sağlar.

Not: İlk kimlik doğrulama sürecini tamamladığınızdan ve API'de başarıyla oturum açtığınızdan emin olun. Ek talimatlar için rehberimize buradan göz atın.

1. Adım: Fakslanacak dosyaları yükleyin

Bir dosya yüklemek için aşağıdaki URL'ye bir HTTP POST isteği gönderin: https://restapi.fax.plus/v3/accounts/[user ID]/files?format=[file format, 'pdf' or 'tiff']

İsteğinize aşağıdaki başlıkları eklediğinizden emin olun:

- Content-Type:
```
multipart/form-data
```

- Authorization:
```
Bearer [access token]
```

- x-fax-clientid:
```
[client ID]
```

Gövde için:

{
  "fax_file": [file]
}

‍

Aşağıdaki örnekte, oturumu açık olan kullanıcının benzersiz kimliğini temsil etmek için kullanıcı kimliği olarak “self” kullanılmıştır:

FAX.PLUS-Send-Fax-API-2.png

FAX.PLUS-Send-Fax-API-3.png

Dosya başarıyla yüklendikten sonra, dosyanın Fax.Plus üzerindeki geçici konumuna giden bir yol alacaksınız.

2. Adım: API kullanarak faks gönderin

Yüklemeler tamamlandıktan sonra faksınızı gönderime hazırlamaya başlayabilirsiniz. Süreci başlatmak için aşağıdaki URL'ye bir HTTP POST isteği gönderin:
https://restapi.fax.plus/v3/accounts/[user ID]/outbox

İsteğinize aşağıdaki başlıkları eklediğinizden emin olun:

- Authorization:
```
Bearer [access token]
```
- x-fax-clientid:
```
[client ID]
```

İstek gövdesi için:

{
"from": "",
"to": [
""
],
"files": [
""
],
"comment": {
"text": ""
},
"send_time": "",
}

FAX.PLUS-Send-Fax-API-4.png

Faks başarıyla zamanlandığında size bir Giden Kutusu Kimliği verilir. Bu kimlik, faks gerçekten gönderilmeden önce üzerinde değişiklik yapmak veya faksı silmek için kullanılabilir.

Not: API'mizde faksların birden fazla kimliği vardır. Bu tasarım, faks iletiminin eşzamansız çalışmasından kaynaklanır. Özellikle, giden bir faks iki ayrı kimlikle tanımlanır: faks başarıyla gönderilene kadar geçerli olan Giden Kutusu Kimliği ve faks başarıyla iletildikten sonra faksın kesin tanımlayıcısı hâline gelen Faks Kimliği.

3. Adım: Gönderdiğiniz faksın durumunu kontrol etmek için webhook'ları kullanın

Faksı zamanladıktan sonra, giden kutusundaki veya gönderilenler kategorisindeki faksların listesini inceleyerek durumunu izleyebilirsiniz.

Alternatif olarak, bir HTTP sunucusu kurup webhook kullanabilirsiniz. Bu, faks başarıyla gönderildiğinde veya gönderimde bir hata oluştuğunda bir HTTP mesajı gönderilmesini tetikler.

Webhook'u kurmak için şu adımları izleyin:

Fax.Plus hesabınızda oturum açın ve Kontrol Panelinizdeki Ayarlar bölümüne gidin.
Entegrasyonlar sekmesinde WebHooks kutusunu bulun.
Gelen Fakslar ve Gelen Fakslar öğelerini bulun. Webhook'u değiştirmek için Yönet'e tıklayın.

Webhook'u kurduktan sonra, giden bir faks işlendiğinde aşağıdaki bildirimi alırsınız:

{
"hook": {
"id": "",
"event": "fax_sent",
"event_time": "2022-12-09 15:50:00",
"target": "http://www.example.com/callback/fax_sent"
},
"data": {
"id": "",
"pages": 1,
"from": "",
"to": "",
"start_time": "2022-12-09 15:50:00",
"file": "",
"file_name": "fax-from-1xxxxxxxxxxxx",
"cost": 1,
"status": "success"
}
}

Bu mesaj size iletim zamanını bildirir, faks iletiminin başarılı olup olmadığını (“status” alanı aracılığıyla) gösterir ve benzersiz faks kimliğini sağlar. Bu faks kimliği, faks dosyasını almak veya faks onay raporunu edinmek için kullanılabilir.

Need Support?