Enterprise Fax APIs Application de fax pour l’envoi et la réception de fax
API pour l’envoi et la réception de fax, et ce, aux quatre coins du monde.
Application mobile ou web : quel que soit votre environnement de développement, avec Retarus Enterprise Fax API
Intuitif et convivial
Envoyez des fax depuis votre logiciel en un clin d’œil. Quelques lignes de code suffisent !
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 Mail-to-Fax 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.
Requête d’envoi de Fax « 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
Requête de réception de Fax :
curl -X POST -u T1: https://faxws.retarus.com/faxin/rest/v1/topics/X
Intéressé(e) par d’autres API et détails ?
Dans notre portail des développeurs, vous trouverez une série de documents de référence sur les API, des guides pour l’intégration des services Retarus dans votre entreprise, ainsi que des SDK pour les principaux langages Web, des extraits de code, des didacticiels et des exemples d’applications pour les cas d’utilisation courants.
Découvrez les avantages de Retarus Enterprise Fax APIs .
Une distribution optimale
Réduisez de 10 % le taux d’échec lors de l’envoi de fax et diminuez le temps consacré aux modifications manuelles de vos envois. Grâce à la technologie NeverBusy de Retarus, il est impossible d'envoyer plusieurs fax simultanément à un même destinataire. Cette technologie soutient le process de la dematérialisation des fax dans votre entreprise et permet de veiller à ce que les fax entrants, même de volume conséquent, ne soient pas retardés par des lignes occupées ou des contraintes de capacité et soient immédiatement distribués.
Routage intelligent
Jusqu'à 30 % de rendement supplémentaire. L’Active Carrier Management du Retarus Enterprise Cloud s’assure que vos fax soient envoyés automatiquement en passant par les itinéraires ou les fournisseurs qui vous offriront la meilleure qualité de ligne et la plus grande disponibilité.
Évolutif et flexible
Éliminez les excédents et les insuffisances de capacité. Le service de fax de Retarus permet de la fléxibilité. Aujourd'hui, vous envoyez 1000 fax ; demain, vous en enverrez peut-être un million : quels que soient vos besoins, le Retarus Enterprise Cloud veille à ce que la bande passante soit optimale, à tout moment.
Haute disponibilité à l’échelle internationale
Une distribution fiable de vos fax numériques, partout dans le monde. Le Retarus Enterprise Cloud dispose d'une haute disponibilité et d’une haute capacité et exploite ses propres centres de données en Europe, en Asie et aux États-Unis afin d’assurer une disponibilité et une fiabilité optimales. C'est un service de fax 24 heures sur 24, 7 jours sur 7.
OCR et lecture de codes-barres
Intégrez les fax à vos flux de travail de manière optimale. Par exemple, en lisant les informations ou les codes-barres des documents entrants à l’aide de la technologie OCR ou de la reconnaissance de codes-barres Retarus afin de pré-trier, transmettre, classer ou traiter automatiquement les documents en fonction d'options de routage intelligent personnalisées basées sur des règles.
Une intégration parfaite
Qu’il s’agisse de systèmes ERP, de systèmes CRM, de Microsoft 365 ou de Google Workspace, les normes ouvertes des Retarus Cloud Fax Services leur permettent de s’intégrer aux applications d’entreprise ou cloud de presque tous les fabricants. Par exemple, par le biais de services Web via RESTful-API ou des interfaces standard et des protocoles tels que SMTP, SFTP et HTTPS.
Contrôle et analyse
Contrôlez l’état de votre communication par fax à tout moment par le biais de tableaux de bord et de rapports détaillés dans le portail d’administration Web EAS (Enterprise Administration Services) de Retarus. Et ce en temps réel ou sur des périodes librement définies. Qu’il s’agisse de fax sortants ou de fax entrants.
Une transparence des coûts absolue
Sécurité et conformité
La dématérialisation des fax est possible en garantissant une sécurité optimale. À l’aide de ses centres de données répartis aux quatre coins du monde, le Retarus Enterprise Cloud respecte les dispositions spécifiques aux pays et aux secteurs les plus strictes concernant les conditions définies par la loi. Celles-ci incluent notamment le RGPD, la norme PCI DSS ou la loi HIPAA.
Chiffrement PGP et X.509
Sécurisez vos communications fax de manière optimale. La connexion au Retarus Enterprise Cloud s’effectue uniquement via des connexions chiffrées (TLS, VPN). Sur demande, Retarus encode et signe également les documents fax entrants ; selon le type de fichier par AES 256 bits, PGP ou X.509.
Archivage à long terme
Respectez les dispositions légales ou spécifiques aux secteurs. Grâce à l’archivage à long terme de Retarus, votre communication par fax est conforme aux exigences de sécurité et d'intégrité des données les plus contraignantes.
SLA de niveau grande entreprise
Service numéros de fax
Recevez des fax partout dans le monde à l’aide de numéros locaux. Grâce au serveur de fax, Retarus met à votre disposition sur tous les continents des numéros de téléphone et de service faciles à gérer et à attribuer depuis le portail EAS. De plus, le portage de numéro de fax existants est possible à tout moment.
Service et Assistance
Misez sur la qualité.
Testez les fax API dès maintenant !
Le Retarus Enterprise Cloud est une infrastructure internationale unique garantissant des services de distribution d’informations fiables par fax, e-mail, SMS et EDI. Depuis 1992, Retarus propose des solutions de communication par fax innovantes aux entreprises. Profitez de notre expertise en intégrant notre solution d’échange de fax à votre logiciel. Simplicité. Rapidité. Fiabilité.