Enterprise Fax APIs für Unternehmen, die mehr wollen als nur eine Schnittstelle
Fax senden und empfangen mit Ihrer Applikation.
Und mit Enterprise-Anspruch.
Entwicklerfreundlich und intuitiv
Versenden Sie Faxe direkt aus Ihrer Anwendung. Einfach. Schnell. Und professionell.
Via REST API, SOAP API oder alternativ per FTP oder SMTP. Ein paar Zeilen Code und los geht’s:
curl -i
-H "Authorization: Basic [InsertYourCredentialsHere]"
-H "Content-Type: application/json"
-X POST
-d '{
"recipients": [
{
"number": "+49891234567890"
}
],
"documents": [
{
"name": "example.txt",
"data": "SGVsbG8sIHRoaXMgaXMgYSB0ZXN0aW5nIGRvY3VtZW50IGJvZHk="
}
],
"renderingOptions": {
"paperFormat": "A4"
},
"statusReportOptions": {
"reportPurgeTs": "2018-08-07T13:34:37.098+02:00"
}
}'
https://faxws.retarus.com/rest/v1/XXXXX/fax
echo '
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://retarus.com/fax4ba/faxws/3/0">
<soapenv:Header/>
<soapenv:Body>
<ns:JobRequest>
<username>myusername</username>
<password>mypassword</password>
<faxRecipient>
<number>+49891234567890</number>
</faxRecipient>
<document>
<name>example.txt</name>
<charset>UTF-8</charset>
<data>VGhpcyBpcyBhIHRlc3QgZmF4IHVzaW5nIFNPQVA=</data>
</document>
</ns:JobRequest>
</soapenv:Body>
</soapenv:Envelope>
' > request.xml
curl -i
-H 'Content-Type: text/xml;charset=UTF-8'
-H 'SOAPAction: ""'
--data @request.xml
https://faxws.retarus.com/Faxolution/v3.0
Reports can be sent via email or through an http web service. For additional sending options you can refer to the following WSDL:
https://faxws.retarus.com/Faxolution/v3.0?wsdl
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE jobs SYSTEM "job.dtd">
<jobs>
<fax>
<fax-file-list>
<fax-file>
<file-name>minimal.pdf</file-name>
</fax-file>
</fax-file-list>
<distribution-list>
<fax-address>
<fax-number>+49891234567890</fax-number>
</fax-address>
</distribution-list>
</fax>
</jobs>
To send a fax using FTP you just need to load on the Retarus FTP server the fax document (e.g. minimal.pdf) and an XML file in the format. The XML file supports most of the options available in other API
Through Retarus Mail2Fax it is possible to send faxes manually through any email client, or in batch by connecting your application through SMTP to the Retarus infrastructure.
[faxnumber]@[us.]rfax.net
Alternatively, a distribution list can be defined as a text file and the message will be sent to all recipients in the list. In this case the destination email address is:
list@[us.]rfax.net
A report will be returned to the sending email address. Further options can be specified by inserting tags in the subject line, for example:
<code>[PRIO:URGENT]</code>: requires an express transmission
<code>[ATTONLY:ON]</code>: only the attachments, not the body of the email, will be sent as fax
<code>[RES:HIGH]</code>: The fax will be sent in high resolution.
Aufruf Fax-Versand „All Options“:
curl -i
-H "Authorization: Basic [InsertYourTokenHere]"
-H "Content-Type: application/json"
-X POST
-d ' {"reference":{"customerDefinedId":"myCustomerDefinedId","billingCode":"myBillingCode","billingInfo":"myBillingInfo"},"recipients":[{"number":"004989312000000000","alternativeNumbers":["004989312000000000123"],"properties":[{"key":"key123","value":"value123"}]},{"number":"0049893120000000002","alternativeNumbers":["004989312000000000123"],"properties":[{"key":"key123","value":"value123"}]}],"documents":[{"name":"document.suffix","charset":"UTF-8","reference":null,"data":"SGVsbG8sIHRoaXMgaXMgYSB0ZXN0aW5nIGRvY3VtZW50IGJvZHkgY3JlYXRlZCBmb3IgOTk5OTlURQ=="}],"transportOptions":{"csid":"csid-inserthere","isExpress":true,"isBlacklistEnabled":false},"renderingOptions":{"paperFormat":"A4","resolution":"HIGH","coverpageTemplate":"coverpage-default.ftl.html","overlay":{"name":"retarus1p","mode":"ALL_PAGES"},"header":"%tz=CEST Testfax: CSID: %C Receiver Number: %# Date: %d.%m.%Y %H:%M %z"},"statusReportOptions":{"reportPurgeTs":"2018-08-07T13:34:37.098+02:00","reportMail":{"successAddress":"my.email.address@mycompany.com","failureAddress":"my.email.address@mycompany.com"},"httpStatusPush":{"targetUrl":"http://mycompany.com/fax-example-push-destinations/insert.here.your.document.name.suffix","principal":"examplePrincipal","credentials":"examplePassword","authMethod":"HTTP_BASIC"}},"meta":{"customerReference":"XXXXXXX","jobValid":{"start":"2016-08-14T14:02:01.497+02:00","end":"2016-08-14T15:02:01.497+02:00"}}} '
https://faxws.retarus.com/rest/v1/XXXXXXX/fax
Aufruf Fax-Empfang:
curl -X POST -u T1: https://faxws.retarus.com/faxin/rest/v1/topics/X
Interessiert an weiteren APIs und Details?
In unserem Developer-Portal finden Sie eine Sammlung von API-Referenzdokumentationen, Anleitungen zur Integration der Retarus Services in Ihr Unternehmen sowie SDKs für beliebte Websprachen, Code-Snippets, Tutorials und Beispiel-Apps für häufige Anwendungsfälle.
Entdecken Sie die Vorteile der Retarus Enterprise Fax APIs .
Optimale Zustellung
Senken Sie die Fehlerrate beim Fax-Versand um bis zu 10% und reduzieren Sie den Aufwand für die manuelle Nachbearbeitung Ihrer Aussendungen. Die Retarus NeverBusy-Technology stellt sicher, dass niemals mehrere Faxe gleichzeitig an einen Empfänger versendet werden. Eingehende Faxe werden dank der Retarus NeverBusy-Technology auch bei grossen Volumina sofort, also ohne besetzte Leitungen oder Kapazitätsengpässe zugestellt.
Intelligentes Routing
Erzielen Sie mit Online Fax Services einen bis zu 30% höheren Durchsatz. Das Active Carrier Management in der Retarus Enterprise Cloud sorgt dafür, dass Ihre Faxe automatisch über die Routen bzw. die Carrier versendet werden, deren Leitungsqualität und Verfügbarkeit am besten zu Ihrem Versandauftrag passen. Mit Retarus als Fax Provider versenden Sie Ihre Faxe auch online stets zuverlässig.
Skalierbar und flexibel
Eliminieren Sie Über- und Unterkapazitäten. Egal, ob Sie heute 1.000 Fax-Dokumente am Tag versenden und morgen eine Million – mit der Enterprise Cloud von Retarus steht Ihnen zu jedem Zeitpunkt genau die Bandbreite zur Verfügung, die Sie gerade benötigen.
Hochverfügbar und global
Verlassen Sie sich auf weltweit zuverlässige Zustellung. Die auf Hochverfügbarkeit und Hochlastfähigkeit ausgelegte Retarus Enterprise Cloud mit selbst betriebenen Rechenzentren in Europa, Asien und in den USA sorgt für maximale Verfügbarkeit und Zustellsicherheit. In jeder Minute an jedem Tag im Jahr.
OCR und Barcode-Erkennung
Dank Fax as a Service integrieren Sie Fax optimal und einfach in Ihre Workflows. Etwa indem Sie Informationen oder Barcodes eingehender Dokumente mit der Retarus OCR und Barcode-Erkennung auslesen und über individuelle Smart-Routing-Optionen regelbasierend vorsortieren, ablegen oder automatisiert weiterverarbeiten. Oder Sie versehen vollautomatisch ausgehende Fax-Aufträge mit Barcodes, um nachgelagerte Prozesse zu automatisieren.
Perfekte Integration
Ob ERP, CRM- oder Legacy-System, Microsoft 365 oder Google Workspace - dank offener Standards lassen sich Retarus Fax Services an Business-Applikationen oder Cloud-Anwendungen nahezu aller Hersteller anbinden. Zum Beispiel per Webservice via RESTful-API oder über Standard-Schnittstellen und Protokolle wie SMTP, SFTP und HTTPS.
Was ausserdem für die Fax-Schnittstellen von Retarus spricht …
Monitoring und Analyse
Kontrollieren Sie den Status Ihrer Fax-Kommunikation zu jeder Zeit über Dashboards und detaillierte Reports im webbasierenden Retarus Enterprise Administration Services Portal. In Echtzeit oder nach frei definierbaren Zeiträumen. Sowohl für ausgehende, als auch für eingehende Faxe.
Absolute Kostentransparenz
Senken Sie Ihre Investitions- und Prozesskosten. Mit Fax as a Service lassen sich die Aufwände für Telefon- und Fax-Infrastrukturen, Fax-Server, Software, Updates, Administration und Wartung massiv reduzieren oder ganz eliminieren. Die Retarus Abrechnungs-Modelle setzen ausschliesslich auf nutzungsbasierte Seiten- bzw. Paketpreise (Pay-per-use).
Sicherheit und Compliance
Vertrauen Sie auf maximale Sicherheit. Die Retarus Enterprise Cloud mit seinen weltweit verteilten Rechenzentren erfüllt die strengsten landes- und branchenspezifischen Vorgaben hinsichtlich Datenschutz und Datensicherheit. Zum Beispiel BDSG, DSGVO, PCI-DSS oder HIPAA.
PGP und X.509 Verschlüsselung
Sichern Sie Ihre Fax-Kommunikation optimal ab. Die Anbindung an die Retarus Enterprise Cloud erfolgt ausschliesslich über verschlüsselte Verbindungen (TLS, VPN). Auf Wunsch signiert und verschlüsselt Retarus auch eingehende Fax-Dokumente für Sie – abhängig vom Dateityp per AES 256-bit, PGP oder X.509.
Langzeit-Archivierung
Halten Sie branchenspezifische oder gesetzliche Vorgaben konsequent ein. Mit der Retarus Langzeitarchivierung erfüllt Ihre Fax-Kommunikation höchste Anforderungen an Datensicherung und Datenintegrität.
Enterprise Level SLAs
Exklusiver Rufnummern-Service
Empfangen Sie Faxe überall auf der Welt mit lokalen Nummern. Retarus stellt auf allen Kontinenten Service- und Rufnummern für Sie bereit, die sich über das EAS-Portal bequem verwalten und zuweisen lassen. Auch die Portierung bestehender Fax-Eingangsnummern ist jederzeit möglich.
Service und Support
Setzen Sie auf Qualität.
Testen Sie die Retarus Enterprise Fax APIs !
Die Retarus Enterprise Cloud ist eine weltweit einzigartige Infrastruktur für zuverlässige Übertragung von Informationen per Fax, E-Mail, SMS und EDI. Seit 1992 steht Retarus für technisch anspruchsvolle Faxkommunikation auf Unternehmensebene. Bauen Sie diese Expertise bei der Faxanbindung jetzt in Ihre Software ein. Einfach. Schnell. Und zuverlässig.