Sélectionner une page

Enterprise Fax APIsApplication 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 APIs, vous disposez d’une interface adaptée. Avec ces API pour l’envoi et la réception de fax, vous profitez des avantages qui vous permettent d’exploiter avec succès la communication par fax : une infrastructure puissante pour votre application de fax, une présence internationale et de nombreuses options d’adaptation à votre processus métier.

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 APIs for personalizing each sending. Reports can be retrieved through the same FTP interface.

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.
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
Retarus Developer Portal

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.

Visitez le portail des développeurs Retarus

Graphic: Developer Portal for SMS, Email and Fax API

Découvrez les avantages de Retarus Enterprise Fax APIs.

N

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.

N

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é.

1

É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.

N

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.

N

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.

N

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.

N

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.

N

Une transparence des coûts absolue

Réduisez vos dépenses d’investissement et vos frais de procédure. Retarus vous aide à réduire massivement voire à supprimer complètement vos dépenses liées aux infrastructures téléphoniques et fax, serveurs fax, logiciels, mises à jour, à l’administration et à la maintenance. Les modèles de facturation Retarus (fixe ou à l’utilisation) se basent uniquement sur des prix par paquet ou par page fixes, quelle que soit la durée de transmission.
N

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.

N

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.

N

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.

N

SLA de niveau grande entreprise

Optez pour un Service Level Agreement conforme aux exigences de votre entreprise en matière de qualité et de rapidité, Les API de fax Retarus conviennent aussi bien pour les start-up que pour les PME-PMI ou les grands groupes internationaux.
N

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.

N

Service et Assistance

Bénéficiez d’une assistance complète. Si vous avez des questions ou si vous souhaitez obtenir une aide personnalisée, l’équipe Retarus Enterprise Fax APIs est à votre disposition.

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é.