
Tek bir başarılı test çağrısı yeterliyse fax API seçmek kolaydır. Zor sorular lansmandan sonra gelir: uygulamanız bir fax'ın geldiğini nasıl öğrenecek ve kaçırdığı bir olayı nasıl kurtaracak? Bu rehber, on sağlayıcıyı API kapsamı, webhook'lar, test ve dağıtım açısından karşılaştırıyor.
| Sağlayıcı | API ve erişim modeli | Webhook ve bildirim modeli | İncelemeye değer uygun kullanım alanı |
|---|---|---|---|
| Fax.Plus | Kurumsal üye, numara ve kişi yönetimi sunan cloud REST API (Enterprise); YZ asistanları için barındırılan MCP sunucusu (ücretli planlar) | Self servis uç nokta yönetimi, imzalı webhook'lar, olay kataloğu, numara bazlı yönlendirme, gelen fax sayfa olayları, teslim günlükleri, yeniden oynatma, otomatik yeniden denemeler ve uç nokta hata uyarıları | Uygulama iş akışlarını, hesap/numara işlemlerini, webhook kurtarmayı ve YZ aracılı fax görevlerini tek bir cloud platformunda isteyen ekipler |
| eFax Enterprise | REST API, OAuth 2.0, hesap ve numara tahsisi; özel geliştirici portalı | Gelen ve giden bildirimler; geliştirici portalında bir sandbox bulunur. Eski portal materyalleri isteğe bağlı HMAC kimlik doğrulamasını anlatır | eFax Corporate hizmetleri üzerinden API'yi ve sandbox ortamını değerlendiren yüksek hacimli kuruluşlar |
| iFax | Hesap API anahtarıyla REST/JSON API | Genel gönderilen ve alınan webhook URL'leri; API kılavuzunda giderek artan bekleme süreleriyle beş adede kadar yeniden deneme belgelenmiştir | Gönderme, alma, durum ve numara yönetimi çağrılarını tek bir hesap anahtarıyla yapmak isteyen ekipler |
| Retarus | Bölgesel REST API; ürün belgelerinde SOAP da sunulmaktadır | İş başına HTTP durum bildirimi (push) veya e-posta raporu; HTTP push Basic, Digest veya OAuth 2.0 kimlik doğrulamasını destekler | Bölgesel uç noktalara ve yapılandırılabilir teslimat durumu raporlamasına ihtiyaç duyan kurumsal entegrasyonlar |
| Concord | Kurumsal web hizmetleri ve uygulama entegrasyonu API'leri; bazı materyaller için geliştirici portalında oturum açmak gerekir | Herkese açık teknik materyaller push ve pull teslimatını anlatır. Bildirim kılavuzu, bir push gecikirse yedek olarak polling kullanılmasını önerir | Köklü bir belge değişimi veya sağlık hizmetleri entegrasyonu programını değerlendiren kuruluşlar |
| InterFAX | Giden ve gelen fax iş akışları için REST API'leri | API başvuru belgelerinde durum geri çağrıları (status callbacks) ve bir geri çağrıyı yeniden gönderme işlemi yer alır; güncel yeniden deneme ve imzalama davranışını doğrulayın | Hem gelen hem de giden işlemleri içeren doğrudan REST iş akışları arayan geliştiriciler |
| WestFax | Kendi kendine kullanılabilen sahte yanıt (mock) sandbox ortamı ve kopyalanabilir örnekler içeren REST API | Geri çağrılar, tamamlanan giden işleri ve gelen fax'ları bildirir. Alıcı, ayrıntılı durumu veya belgeyi ayrıca alır | Hesap kurulumundan önce sahte yanıtlar üzerinde prototip oluşturmak isteyen geliştiriciler |
| RightFax / OpenText Fax | Şirket içi, hibrit veya özel cloud fax altyapısı için Web API | Güncel sürüm tablosunda Web API yeniden deneme sayısı ve yeniden deneme aralığı özellikleri belgelenmiştir; herkese açık, self-servis webhook işlemleri açıklanmamıştır | Mevcut bir fax sunucusu ortamını denetiminde tutması gereken veya hibrit bir dağıtıma ihtiyaç duyan kuruluşlar |
| Documo | API ve portal tabanlı cloud fax iş akışları; webhook kurulumu hesap veya fax numarası düzeyinde yapılır | Yedi zamanlanmış yeniden deneme belgelenmiştir, ardından bir e-posta uyarısı gönderilir. Basic kimlik doğrulama etkinleştirilebilir | Olayları hesap veya fax numarası düzeyinde yönlendiren ekipler |
| SRFax | Hesap kimlik bilgilerini kullanan HTTPS POST API; JSON veya XML yanıtları | Giden durum geri çağrıları (status callbacks) belgelenmiştir; yedek olarak polling kullanılabilir | Eylem tabanlı bir API ile geri çağrı artı polling modeliyle çalışabilen entegrasyonlar |
Fax.Plus, cloud öncelikli ekipler için öne çıkıyor; diğerleri daha dar kapsamlı entegrasyon veya dağıtım ihtiyaçlarına uygundur. Doğru kısa liste; iş akışının ne kadarını denetlemek istediğinize, uygulamanızın kesintilerden nasıl toparlanacağına ve bir cloud hizmeti mi yoksa işlettiğiniz fax altyapısına bağlı bir API mi istediğinize bağlıdır.
Bir API fax göndermeyi destekliyor olsa bile üretim iş akışı için yetersiz kalabilir. Entegrasyonun tamamını değerlendirmek için şu soruları kullanın:
Fax göndermek yalnızca bir adımdır. İki yönlü bir uygulamanın ayrıca gelen fax'ları alması, listelemesi, belgeleri indirmesi, iletim durumunu kontrol etmesi, numaraları yönetmesi ve işleri durdurması veya yeniden göndermesi gerekebilir. Uç nokta sayılarını karşılaştırmadan önce, uygulamanızın ihtiyaç duyduğu iş akışını baştan sona çizin.
Ardından fax belgesinin kendisinin nereden geçtiğini kontrol edin. Bazı geri çağrılar yararlı meta veriler içerir, ancak PDF veya TIFF dosyasını ayrı bir API çağrısıyla almayı uygulamaya bırakır. Bu ayrım güvenlik ve yük boyutu açısından yardımcı olabilir, ancak entegrasyonunuzun olayı saklaması, belgeyi alması ve geçici bir indirme hatasını ele alması gerekir.
“Sandbox” çok farklı anlamlara gelebilir. Sahte yanıtlar döndürebilir, test numaralarını kabul edebilir, gerçek bir fax gönderebilir veya yalnızca hesap kurulumunu test etmenize izin verebilir. Üretimin hangi bölümlerini çalıştırdığını, test hesabının aynı özelliklere ve sınırlara sahip olup olmadığını ve sağlayıcının hangi verileri sakladığını sorun.
Fax.Plus API sandbox erişimi, API iletişim formu aracılığıyla talep üzerine sağlanır ve ekip bunu ayarlar. Diğer sağlayıcılar için sandbox'ın gerçek fax gönderip göndermediğini veya sahte yanıtlar döndürüp döndürmediğini sorun.
Alıcının fax makinesi meşgulse fax sağlayıcısı iletimi yeniden deneyebilir. Durum bildirimini alırken sunucunuz zaman aşımına uğrarsa sağlayıcı webhook'u yeniden deneyebilir. Bunlar, farklı hata nedenleri ve kurtarma işlemleri olan iki ayrı kuyruktur.
Fax.Plus ayrıca uygun çok sayfalı iletimler için Kısmi Gönderimde Otomatik Devam ayarı sunar. Etkinleştirildiğinde devam eden iletim, gönderilmemiş bir sonraki sayfadan başlayabilir; bu nedenle alıcı fax'ı birden fazla iletimle alabilir. Bu, webhook yeniden denemesinden veya yeniden oynatmadan ayrı bir fax teslim davranışıdır.
Webhook alıcınız hızlı bir şekilde başarılı bir HTTP yanıtı döndürmeli, olayı kaydetmeli veya kuyruğa almalı ve eşzamansız olarak işlemelidir. Ayrıca yinelenen olaylara karşı toleranslı olmalıdır. Bir yeniden deneme aynı olayı birden fazla kez iletebilir ve yeniden oynatma, sisteminizin işlemediği bir olayı yeniden gönderir. Yazılımda aynı olayı işi tekrarlamadan güvenle ele almaya idempotency denir.
Webhook, bir olay gerçekleştiğinde bir hizmetin uygulamanıza gönderdiği otomatik bir HTTP isteğidir. Tekrar tekrar “Fax tamamlandı mı?” diye sormak yerine, sağlayıcının bir güncellemesi olduğunda sisteminiz bir mesaj alır.
En azından sağlayıcının giden fax'ların tamamlanması ve gelen fax'lar için olay gönderip göndermediğini kontrol edin. Ardından yükü ve her durumun anlamını inceleyin. “Fax gönderildi” olayı, fax işinin bittiği anlamına gelebilir; başarılı olduğu anlamına gelmeyebilir. Uygulamanızın yine de gerçek teslim durumunu denetlemesi gerekir.
Bazı iş akışları sayfa düzeyindeki olaylardan yararlanır. Örneğin bir ekip, gönderen tüm sayfaları iletmeyi bitirmeden gelen bir sevk paketini incelemeye başlayabilir. Fax.Plus, Fax akışı etkinleştirildiğinde bir sayfa alındı olayını belgelendirir. Documo'nun olay referansı da gelen sayfa olayını listeler. Belgenin tamamının nasıl alındığını ve sayfa olayları tamamlanmış fax kaydından önce gelirse ne olacağını doğrulayın.
HTTPS, veriler sunucular arasında iletilirken bağlantıyı korur. İmza, alıcınıza ek bir denetim sağlar: isteğin sağlayıcıyla paylaşılan bir gizli anahtarla imzalandığını ve istek gövdesinin değiştirilmediğini doğrulayabilir. Fax.Plus, güncel webhook API'si için uç noktaya özgü bir gizli anahtar ve zaman damgası denetimiyle HMAC-SHA256 imzalarını belgelendirir. eFax'ın eski API portalı kılavuzu isteğe bağlı HMAC kimlik doğrulamasını açıklar. Retarus, HTTP durum bildiriminde Basic, Digest ve OAuth 2.0 dahil kimlik doğrulama seçeneklerini destekler.
Hangi sağlayıcı olursa olsun, satın aldığınız API sürümü ve ürün için hangi kimlik doğrulama seçeneğinin geçerli olduğunu doğrulayın. İmzalamanın mümkün olduğu yerlerde, IP izin listesini veya tahmin edilmesi zor bir URL'yi imzalı mesajları doğrulamanın yerine koymayın.
Yeniden denemeler geçici kesintilerde yardımcı olur, ancak her destek sorusunu yanıtlayamaz. Teslim günlüğü, bir mühendisin hizmetin olayı gönderip göndermediğini, uç noktanızın hangi yanıtı döndürdüğünü ve sağlayıcının tekrar deneyip denemeyeceğini görmesine yardımcı olur. Yeniden oynatma (replay), yetkili bir kullanıcının alıcıyı düzelttikten sonra kaçırılan bir olayı yeniden göndermesini sağlar.
Fax.Plus; webhook teslim günlükleri, otomatik yeniden denemeler, uç nokta hata uyarıları ve seçilen bir zaman aralığındaki olayların yeniden oynatılması dahil olmak üzere self-servis yeniden oynatma sunar. Documo, planlanan yeniden denemeleri tükendikten sonra e-posta gönderir. InterFAX'ın API referansları, bir geri çağrıyı yeniden göndermenin bir yolunu içerir. Diğer sağlayıcılar için üretim günlüğünü ve yeniden oynatma iş akışını göstermelerini isteyin; ayrıca yeniden denemenin otomatik mi, manuel mi, yoksa her ikisi birden mi olduğunu netleştirin.
Uygulamanız birden fazla müşteriyi, departmanı veya fax numarasını destekliyorsa, webhook uç noktalarının nasıl ayrılabileceğini sorun. Fax portalındaki numara-ekip ayarı, API olaylarını fax numarasına göre filtrelemekle her zaman aynı şey değildir.
Fax.Plus, olaya ve numaraya göre filtreleri destekler; portalı da birden fazla uç noktayı yönetebilir. Bu, ekiplerin olayları fax numaraları ve iş akışları arasında yönlendirmesine yardımcı olur. Documo, hesap düzeyinde ve numara düzeyinde webhook kurulumunu belgelendirir. WestFax, hatta özel geri çağrı yapılandırmasını belgelendirir. Ayrıca yeni numaraların ayarları nasıl devraldığını da doğrulayın.
Fax.Plus, fax göndermek ve almak, kurumsal hesapları yönetmek ve uygulamalarından olay teslimini ele almak isteyen ekipler için bir cloud fax API'sidir. İmzalama aynı paketin içine yerleşiktir: gelen kutusundaki veya gönderilenler klasöründeki herhangi bir fax, Alohi'nin kendi e-imza ürünü olan Sign.Plus'a iletilerek kendiniz imzalayabilir veya aynı hesap altında başkalarından imza isteyebilirsiniz; mobil uygulamalar da alınan bir fax'ı imzalayıp doğrudan geri göndermenizi sağlar.
Webhook deneyimi; olay abonelikleri, numara bazlı yönlendirme, uç noktaya özel HMAC imzaları, teslim tanımlayıcıları, bir olay kataloğu, teslim günlükleri, otomatik yeniden denemeler, başarısız olaylar veya seçilen bir zaman aralığı için yeniden oynatma ve bir uç nokta hata vermeye başladığında uyarılar içerir. Numara filtreleriyle her uç nokta yalnızca listelediği fax numaraları için olay alır; böylece birden fazla müşteriye hizmet veren bir platform, her müşterinin numaralarına kendi uç noktasını ve gizli anahtarını verebilir. Fax akışı, gelen fax'lar için sayfa bildirimleri ekler. Ekipler teslim denemelerini portaldan inceleyebilir ve hedef hazır olduğunda olayları yeniden oynatabilir; bu da kaçırılan bir bildirimi araştırmayı veya olayları birden fazla fax numarası arasında yönlendirmeyi kolaylaştırır. Güncel API'si, geçiş sürecinde eski webhook API'siyle birlikte çalışır; uygulama ayrıntıları için webhook belgelerine bakın.
Fax işlemlerinin yanı sıra REST API hesap yönetimini de üstlenir: kurumsal üyeler, roller ve fax kotaları, davetiyeler, fax numarası satın alma ve atama, kişiler ve gruplar; hepsi Enterprise API üzerindeki izin kapsamlı uç noktalar aracılığıyla yapılır. Hesaplar, numara yönetimi ve numara satın alma referanslarına bakın.
Fax.Plus ayrıca platform kullanılabilirliğini, ekiplerin hizmet güncellemelerini kontrol edebileceği durum sayfasında yayımlar.
Gönderim ve ölçek açısından API, bir gönderim isteğinde bir veya daha fazla hedefi ve yapılandırılabilir fax iletimi yeniden deneme sayısı ile gecikmesini destekler; bunu fax gönderme örneğinde görebilirsiniz. Fax.Plus ayrıca, etkinleştirildiğinde uygun çok sayfalı fax'lar için Kısmi Gönderimde Otomatik Devam özelliği sunar. Fax.Plus, plan düzeyindeki sayfa, dosya ve eşzamanlı iletim sınırlarını fiyatlandırma ayrıntılarında yayımlar; daha yüksek hacim için Enterprise seçenekleri mevcuttur. Fax durum kayıtları ve onay raporları, tek tek iletim sonuçlarının mutabakatına yardımcı olur.
Özel bir arka uç entegrasyonuna ihtiyaç duymayan ekipler, Zapier gibi kodsuz uygulama bağlantılarını da kullanabilir. Bu, desteklenen iş akışları için pratik bir alternatiftir.
Fax akışı etkinleştirildiğinde Fax.Plus, gelen bir fax'ın her sayfası alındığı anda bir olayı gönderir ve o sayfa, tek sayfalık bir dosya olarak API üzerinden hemen kullanılabilir hale gelir. Alım sistemleri, tüm belgeyi beklemek yerine geri kalanı hâlâ gelirken bir sevk paketini 1. sayfadan itibaren sınıflandırabilir veya yönlendirebilir. Akış, istek üzerine tüm hesap için etkinleştirilir ve olayın belge içeriği yerine fax ayrıntılarını taşıdığı HIPAA hesaplarında da çalışır.
Model Context Protocol (MCP), uyumlu YZ asistanlarının harici araçlara bağlanmasını sağlar. Fax.Plus, bir asistanın doğal dilde isteklerle fax göndermesine, gelen belgeleri kontrol etmesine, teslimi izlemesine ve kişileri yönetmesine olanak tanıyan barındırılan bir MCP sunucusu sunar. Tek bir uç nokta, desteklenen MCP istemcilerinin tamamında çalışır; böylece ekipler her asistan için ayrı bir bağlayıcı bakımı yapmadan fax işlemlerini YZ iş akışlarının içinde kullanılabilir hale getirebilir. OAuth, ücretli Fax.Plus planlarında kullanılabilir; Enterprise ayrıca yapılandırılabilir kapsamlara sahip Kişisel Erişim Belirteçlerini de destekler. Asistan öncülüğündeki fax görevleri için MCP'yi, webhook yapılandırması, numara tahsisi ve kurumsal üye yönetimi gibi uygulama kontrollü iş akışları için ise REST API'yi kullanın. Fax.Plus MCP sunucusu ve geliştirici belgeleri hakkında daha fazla bilgi edinin.
REST API ve webhook'lar Enterprise planında, MCP ise Basic ile başlayan ücretli planlarda kullanılabilir. Fax.Plus Enterprise ve HIPAA fax iş akışı hakkında daha fazla bilgi edinin.
En uygun olduğu kullanım: REST API otomasyonuna, kurtarılabilir webhook operasyonlarına ve fax işlemlerini YZ asistanlarına bağlamanın doğrudan bir yoluna ihtiyaç duyan cloud öncelikli ekipler.
eFax Enterprise, bir cloud REST fax API'sini hesap ve numara tahsisiyle birleştirir. Herkese açık API sayfası; OAuth 2.0'ı, gönderme ve almayı, fax görüntüsü ve meta veri alımını, webhook'ları ve bir sandbox içeren özel bir geliştirici portalını tanımlar. Fax.Plus de üye ve numara yönetimini REST API'si üzerinden sunar; eFax ise hâlihazırda eFax Corporate kullanan ve özel geliştirici portalı modelini tercih eden kuruluşlara uygun olabilir.
API sayfası, güvenli gelen ve giden bildirimleri anlatıyor. Bir portal hızlı başlangıç kılavuzu da gönderilen bir URL üzerinden fax alımını açıklıyor ve HMAC kimlik doğrulamasının zorunlu tutulabileceğini belirtiyor. Bu kılavuz güncel pazarlama sayfasından daha eski olduğu için, fiyat teklifi alınan API ortamında hangi imzalama, sandbox, olay ve teslim günlüğü özelliklerinin bulunduğunu eFax'a sorun. Portal özel olduğundan, bir geliştiricinin tüm başvuru belgelerini görebilmesi için hesap açması veya satış ekibiyle iletişime geçmesi gerekebilir.
En uygun olduğu kullanım: API tabanlı fax gönderimi, hesap yönetimi ve numara tahsisi içeren yönetilen cloud fax hizmeti arayan büyük kuruluşlar.
iFax; giden fax gönderimini, alınan fax'ları, durum kontrollerini, belge indirmelerini ve numara işlemlerini kapsayan bir REST API başvuru belgesi yayımlıyor. Hesap API anahtarı ve JSON yanıtları kullanıyor. Belgeler ayrıca webhook davranışını da açıklıyor: gönderilen ve alınan fax'ler için genel URL'ler, bir fax tamamlandıktan sonra gönderilen postflight bildirimleri ve yayımlanmış bir geri çekilme (backoff) takvimiyle en fazla beş yeniden deneme.
Genel olay URL'leri, hesap genelinde basit bir kurulum için uygundur. İmzalı isteklere, yeniden oynatmaya (replay) veya teslim geçmişi araçlarına ihtiyaç duyan ekipler, bu kontrollerin hesaplarına ve entegrasyonlarına nasıl uyduğunu iFax'a sormalıdır.
En uygun olduğu kullanım: Hesap genelinde webhook URL'leri olan, API anahtarlı bir REST entegrasyonu isteyen geliştiriciler.
Retarus, diğer kurumsal entegrasyon seçeneklerinin yanı sıra uygulamalardan fax göndermek için bölgesel bir REST API sunuyor. Kılavuzunda, sorgulanabilen (polling) veya müşterinin uç noktasına gönderilebilen durum raporları anlatılıyor. Tek bir iş için HTTP durum gönderim URL'si belirleyebilir ya da varsayılan bir hesap URL'si yapılandırabilirsiniz. Belgelenmiş kimlik doğrulama seçenekleri arasında Basic, Digest ve OAuth 2.0 bulunuyor. Durum raporları, en fazla 30 gün boyunca veya elle silinene kadar alınabilir durumda kalıyor.
Bu, bölgesel uç noktalara, rapor saklamaya ve yönetilen hizmetin parçası olarak yapılandırılan kimlik doğrulamaya ihtiyaç duyan kuruluşlara uygundur. Retarus, geliştiricilerden test hesabı için şirketle iletişime geçmelerini istiyor. Herkese açık kılavuzunda webhook teslimini yeniden oynatma (replay) veya olay bazlı bir panel anlatılmıyor; bu nedenle değerlendirdiğiniz hizmette uç nokta hatalarının nasıl izlendiğini ve nasıl giderildiğini sorun.
En uygun olduğu kullanım: Sağlayıcı öncülüğünde yürütülen bir entegrasyonun parçası olarak bölgesel hizmet seçenekleri ve yapılandırılabilir durum iletimi isteyen kurumsal ekipler.
Concord'un geliştirici materyalleri, gelen belgeleri kabul eden ve işlenmiş dosyaları HTTP push veya pull ile döndüren API'ler dahil olmak üzere fax ve belge değişimi entegrasyonlarını kapsıyor. Bazı geliştirici kaynakları portal girişi gerektiriyor; herkese açık materyaller ise farklı belge alanlarına ve API nesillerine yayılıyor. Uç nokta ayrıntılarını karşılaştırmadan önce hangi Concord ürününü, API sürümünü ve dağıtım modelini kullanacağınızı doğrulayın.
Herkese açık bir giden bildirim kılavuzu, push'a yedek olarak pull tabanlı bir durum kontrolü uygulanmasını öneriyor. Bir push'ın birkaç dakika gecikebileceğini veya hedef sunucu kullanılamadığında gecikebileceğini belirtiyor. Her bildirimin uygulamanızın beklediği anda ulaşacağını varsaymak yerine bir mutabakat yolu planlayın. Değerlendirdiğiniz belirli hizmet için güncel webhook kimlik doğrulaması, yeniden deneme, yeniden oynatma (replay) ve teslim günlüğü ayrıntılarını Concord'a sorun.
En uygun olduğu kullanım: Concord'un daha geniş belge değişimi ve kurumsal entegrasyon yeteneklerini, özellikle fax'ın daha büyük bir programın parçası olduğu durumlarda değerlendiren kuruluşlar.
InterFAX, giden ve gelen fax işlemleri için REST başvuru belgeleri yayımlıyor. Belgeler gönderimi, durum almayı, gelen belgelerle çalışmayı ve diğer iş yönetimi eylemlerini kapsıyor. API başvurusunda ayrıca bir geri çağrıyı yeniden gönderme (callback-resend) işlemi de yer alıyor; bu, geliştiricilere geri çağrıyı yeniden talep etmek için belgelenmiş bir yol sunuyor.
Buna dayalı bir yapı kurmadan önce hangi geri çağrı olaylarını kapsadığını, başarısız teslimlerin otomatik olarak yeniden denenip denenmediğini ve ekibinizin geçmiş denemeleri nasıl inceleyebileceğini netleştirin. İmzalı geri çağrılara, filtrelemeye ve portal üzerinden yeniden oynatmaya (replay) ihtiyaç duyan ekipler, bu kontrollerin kullanmayı planladıkları InterFAX hizmetinde nasıl çalıştığını doğrulamalıdır.
En uygun olduğu kullanım: Hem gelen hem giden fax iş akışları için doğrudan bir REST API isteyen ve geri çağrı işlemlerini sağlayıcıyla doğrulayabilen geliştiriciler.
WestFax'ın geliştirici portalı; ücretsiz sandbox kimlik bilgileri, üretim ortamındaki istek yollarını ve yanıt yapılarını izleyen sahte (mock) REST API'ler ve geliştiricilerin kopyalayabileceği örnekler sunuyor. Sandbox, bir ekibin gerçek fax göndermeden geri çağrı sonuçlarını simüle etmesine olanak tanıyor.
Hızlı başlangıç kılavuzu, giden akışı iki bölümde açıklıyor: iş bittiğinde WestFax bir URL'yi çağırıyor, ardından uygulama başka bir API çağrısıyla alıcı bazında ayrıntılı durumu alıyor. Gelen geri çağrılar da benzer şekilde uygulamaya bir fax'ın ulaştığını bildiriyor; ardından uygulama meta verileri ve PDF'yi alıyor. Kılavuz, başarılı bir yanıtı hızlıca döndürmeyi ve işleri eşzamansız olarak işlemeyi öneriyor; ayrıca yavaş bir uç nokta geri çağrıyı yeniden alabileceğinden idempotent (tekrarlara karşı güvenli) işleme yapılmasını da tavsiye ediyor. Yayına almadan önce üretim ortamı kimlik doğrulamasını, geri çağrı yeniden deneme takvimini, imzalama seçeneklerini ve olay yeniden oynatmayı (replay) doğrulayın.
En uygun olduğu kullanım: Üretim erişimi sağlamadan önce API mantığını sahte (mock) bir ortamda geliştirip denemek isteyen geliştiriciler.
RightFax artık OpenText tarafından OpenText Fax adıyla pazarlanıyor. OpenText; şirket içi (on-premises), hibrit ve özel cloud dağıtım seçeneklerini tanımlıyor. Bu da onu, hâlihazırda fax altyapısı işleten veya fax sunucusunun nerede çalışacağı üzerinde denetim isteyen kuruluşlar için uygun kılıyor; ancak barındırılan, kendi kendine kullanılabilen bir cloud API'den farklı bir karşılaştırma konusudur.
OpenText'in sürüm karşılaştırma tablosu, yapılandırılabilir yeniden deneme sayısı ve yeniden deneme aralığı özellikleri dahil olmak üzere Web API geliştirmelerini belgeliyor. Önceki ürün belgeleri ise fax gönderme, alma, durum kontrolü, yönlendirme, iletme, yeniden deneme ve iptal etme için API işlemlerini anlatıyor. Ayrıntılı API başvuru belgeleri çoğunlukla sunucu sürümüne ve müşteri erişimine bağlıdır; bu nedenle desteklenen sürümü, lisanslamayı, barındırma sorumluluğunu ve yükseltme yolunu OpenText veya uygulama iş ortağıyla doğrulayın.
En uygun olduğu kullanım: Müşteri tarafından işletilen veya hibrit bir fax sunucusu ortamına bağlı bir API'ye ihtiyaç duyan kuruluşlar.
Documo'nun webhook belgeleri, hesap veya fax numarası düzeyinde yapılandırmayı, çeşitli gelen ve giden fax olaylarını ve isteğe bağlı HTTP Basic kimlik doğrulamasını açıklar. Daha uzun bir geri çekilme (backoff) aralığında yedi denemeden oluşan bir yeniden deneme programı yayımlar. Tüm denemeler başarısız olursa, belgelere göre hata ve webhook verilerini içeren bir e-posta gönderilir. Olay başvuru belgesi ayrıca webhook isteğinin tamamlanması ve başarısız olması olaylarını da tanımlar.
Webhook, belge akışının yalnızca bir parçasıdır. Gelen olaylar sayfa sayfa gelebilirken uygulama fax dosyasını API üzerinden alabilir. Olay işleme ile belge indirme adımlarını ayrı planlayın; ayrıca izinlerin, saklama sürelerinin ve yeniden denemelerin hesabınızda nasıl çalıştığını doğrulayın. Documo'nun herkese açık kaynakları hem portal kurulum talimatlarını hem de API başvurularını içerir; ekibinizin, teklifte yer alan ürün ve API yapılandırmasını tam olarak incelediğinden emin olun.
En uygun olduğu kullanım: Numara düzeyinde webhook yönlendirmesi isteyen ve belge almak için ayrı bir API adımını kabul eden ekipler.
SRFax'ın geliştirici kılavuzu, JSON veya XML yanıtları döndüren bir HTTPS POST API'sini açıklar. Eylem tabanlı işlemleri; bir fax'ı kuyruğa almayı, bir veya daha fazla fax'ın durumunu sorgulamayı, gelen ve giden kutusu öğelerini almayı, fax dosyalarını indirmeyi ve kuyruktaki işleri yönetmeyi kapsar. Sağlayıcı ayrıca indirilebilir istemci sınıfları ve örnekler yayımlar.
Giden fax güncellemeleri için SRFax, bir iş kuyruğa alındıktan sonra fax durumu alanlarını bir URL'ye gönderen sNotifyURL parametresini belgelendirir. API belgeleri, bildirim kaçırılırsa geliştiricilerin yine de durumu yoklayabileceğini (polling) belirtir. Bu geri çağrı (callback) artı yoklama yedeği işe yarar, ancak herkese açık kılavuz modern bir olay portalıyla aynı operasyonel ayrıntıyı sunmaz. Gelen fax bildirimlerini, geri çağrı kimlik doğrulamasını, teslim yeniden denemelerini ve hesabınız için bir günlük veya manuel yeniden oynatma (replay) seçeneği olup olmadığını sorun.
En uygun olduğu kullanım: Eylem tabanlı bir API'yi, indirilebilir kod örneklerini ve giden fax durum bildirimleri için yoklama yedeğini rahatça kullanabilen ekipler.
API protokolü, kararın yalnızca bir parçasıdır. Dağıtım modeli; uygulamayı, sahipliği, desteği ve geçişi etkiler.
Bu kategoriler birbiriyle örtüşür. Bir sağlayıcı birden fazla teslim yolu sunabilir ve yönetilen bir cloud hizmeti de teknik bir devreye alma süreci gerektirir. Satıcıdan, teklifinizdeki ürün ve dağıtımı incelediğiniz API belgeleriyle tam olarak eşleştirmesini isteyin.
Sağlayıcıları temel ölçütlere göre karşılaştırın:
Bir uygulama API'sine, operasyonel webhook'lara ve YZ aracısı iş akışlarına açılan bir yola ihtiyaç duyan cloud öncelikli ekipler için en çok önerdiğimiz seçenek Fax.Plus'tır. REST API, uygulama tarafından kontrol edilen fax işlemlerini destekler. İmzalı ve filtrelenebilir webhook'lar, ekiplere olay teslimi ve kurtarma konusunda görünürlük sağlar. Barındırılan MCP sunucusu, uyumlu asistanları günlük fax görevlerine bağlar. Bu özellikler birlikte, ekiplere yerleşik arka uç entegrasyonları ve yeni nesil konuşma tabanlı iş akışları için tek bir platform sunar.
Diğer sağlayıcılar daha dar ihtiyaçlara uyar: Corporate hizmetini zaten kullanan kuruluşlar için eFax, müşteri tarafından işletilen veya hibrit fax altyapısı gerektiren ekipler için RightFax/OpenText. API'leri, hesap ve numara yönetimini, webhook'ları ve YZ asistanlarını kapsayan modern bir cloud fax iş akışı kuran ekipler için Fax.Plus, bu karşılaştırmadaki en güçlü genel seçimdir. Uygulama entegrasyonları için Fax.Plus API'sini, fax'ı YZ destekli iş akışlarına taşımak için ise MCP'yi kullanın.
API otomasyonu, webhook işlemleri ve YZ aracısı erişimini tek bir fax platformunda isteyen cloud öncelikli kuruluşlar için ilk tavsiyemiz Fax.Plus'tır. REST API'si uygulama denetimli iş akışlarını destekler, webhook'ları teslim görünürlüğü ve yeniden oynatma (replay) sunar, barındırılan MCP sunucusu ise fax işlemlerini uyumlu YZ asistanlarına taşır. Gereksinim müşteri tarafından işletilen veya hibrit bir fax sunucusuysa RightFax/OpenText daha uygundur.
Özel bir entegrasyon geliştiriyorsanız genellikle evet. Bir geliştirici veya entegrasyon ortağı; isteklerin kimliğini doğrulamak, belgeleri göndermek ve almak, durum güncellemelerini işlemek ve alıcı iş akışını yeniden denemelere veya yinelenen olaylara karşı dayanıklı hâle getirmek zorunda kalacaktır. Geliştirme kaynağınız yoksa Fax.Plus kodsuz seçenekler sunar: desteklenen iş akışları için Zapier bağlantıları ve YZ asistanlarının özel kod olmadan fax göndermesini ve takip etmesini sağlayan barındırılan bir MCP sunucusu.
“Toplu” ifadesi, birden fazla hedefe gönderilen tek bir fax'ı, ayrı fax işlerinden oluşan bir grubu veya alınan çok sayıda belgenin indirilmesini ifade edebilir. Fax.Plus, tek bir istekle birden fazla hedefe göndermeyi, yapılandırılabilir fax iletim yeniden denemelerini ve yüksek hacimli Enterprise iş akışlarını destekler. Uygulamalar API üzerinden fax kayıtlarını listeleyebilir ve fax belgelerini alabilir. Enterprise planları daha yüksek hacimli iş yüklerini destekler; sayfa, dosya ve eşzamanlılık sınırları için fiyatlandırmaya bakın.
Evet. Kısmi Gönderimde Otomatik Devam etkinleştirildiğinde, uygun çok sayfalı fax'lar gönderilmeyen bir sonraki sayfadan devam edebilir. Alıcı, orijinal fax ve devamı için ayrı iletimler alabilir. Bu, webhook yeniden denemelerinden ayrı bir özelliktir.
Evet. Sandbox erişimi, Fax.Plus API sayfasındaki iletişim formu aracılığıyla talep üzerine sağlanır ve ekibimiz bunu ayarlar.
OpenText tarafından OpenText Fax adıyla pazarlanan RightFax; şirket içi, hibrit ve özel cloud dağıtımlarını destekler. Web API'si bu sunucu ürünüyle ilişkilidir; bu nedenle entegrasyonun bir parçası olarak sunucu sürümünü, barındırma düzenini, lisanslamayı ve yükseltme sürecini planlayın.
Belirli ürünün, planın ve dağıtımın kuruluşunuzun güvenlik ve gizlilik gereksinimlerini karşılayabildiğini doğrulayın. Sağlayıcının API iş akışı için BAA imzalayıp imzalamayacağını, hangi özelliklerin veya ayarların gerekli olduğunu, belgelerin ve webhook yüklerinin nerede işlendiğini, kayıtların ne kadar süre saklandığını ve erişimin nasıl denetlendiğini sorun. Yalnızca bir uyumluluk etiketi, belirli iş akışınızın uygun olup olmadığını tek başına belirlemez. Fax.Plus plan koşulları için Fax.Plus HIPAA fax kılavuzuna bakın.
Bazı sağlayıcılar sayfa düzeyinde olayları belgeler. Fax.Plus, Fax akışı etkinleştirildiğinde bir sayfa alındı olayını belgeler; Documo ise gelen sayfa olayını listeler. Uygulamanızın son sayfa gelmeden önce harekete geçmesi gerekiyorsa olay sırasını, belge alma yolunu ve bir sayfa olayı tekrarlandığında veya geciktiğinde davranışı doğrulayın.
