Seleziona una pagina

FAX API RETARUS ENTERPRISEPer gli sviluppatori che vogliono più di una semplice interfaccia

Inviare e ricevere i fax con la applicazione. In tutto il mondo.

Gli API Retarus Enterprise Fax, per le applicazioni mobili o web, ti permettono di trovare interfaccia adeguati per il tuo ambiente di sviluppo. E soprattutto soluzioni che ti permettono di soddisfare l’esigenza principale in materia di utilizzo del fax: un’infrastruttura potente. Disponibilità internazionale. Un’ampia gamma di opzioni per garantire la personalizzazione ideale in linea con i tuoi processi commerciali.

Intuitivo e facile da usare

Puoi adesso mandare i fax direttamente dal tuo software. Velocemente. E professionalmente. Bastano alcune stringhe di codici ed il gioco è fatto!

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.
Apertura “All Options” per Invio-Fax:
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
Apertura ricezione fax:
curl -X POST -u T1: https://faxws.retarus.com/faxin/rest/v1/topics/X
Retarus Product Documentation Center

Sei interessato a ulteriori API e dettagli?

Nel nostro portale per gli sviluppatori troverai una raccolta di documenti di riferimento sulle API, guide per l’integrazione dei servizi Retarus nella tua azienda, nonché SDK per i più diffusi linguaggi web, snippet di codice, tutorial e applicazioni di esempio per i casi d’uso più comuni.

Visita il Retarus Product Documentation Center

Graphic: Developer Portal for SMS, Email and Fax API

Scopri anche tu i vantaggi degli API Retarus Enterprise Fax.

N

Invio ottimale

Puoi ridurre la percentuale di errore relativa all’invio dei fax fino al 10% e quindi il tempo necessario per l’elaborazione manuale delle tue spedizioni. La tecnologia NeverBusy di Retarus permette di evitare che uno stesso destinatario riceva contemporaneamente più trasmissioni fax. Grazie alla tecnologia NeverBusy di Retarus è possibile inviare immediatamente grandi quantità di fax senza occupare le linee o causare problemi di capacità.

N

Routing intelligente

Rendimento più elevato fino al 30%. L’Active Carrier Management di Retarus Enterprise Cloud permette di inviare automaticamente i fax tramite un carrier la cui disponibilità e qualità di rendimento vengono adeguati alle tue esigenze di spedizione specifiche.

N

Scalabile e flessibile

Sovraccapacità e sottocapacità sono lontani ricordi del passato. Indipendentemente dal fatto che invii oggi 1.000 fax e domani un milione - con Retarus Enterprise Cloud avrai sempre a disposizione la larghezza di banda ideale per le tue esigenze specifiche.

N

Altamente disponibile e globale

Puoi contare su trasmissioni affidabili in tutto il mondo. Retarus Enterprise Cloud impostato su un elevato livello di disponibilità e capacità, dispone di centri di elaborazione propri in Europa, Asia e USA e quindi garantisce una disponibilità del servizio massima e globale. Ogni minuto, 365 giorni l’anno.

N

OCR e riconoscimento codice a barre

Per integrare in modo ottimale il fax nel tuo flusso di lavoro. Per esempio, puoi leggere le informazioni o i codici a barre dei documenti in entrata con Retarus OCR o con il rilevamento di codice a barre, poi organizzare, inoltrare, archiviare o elaborare i documenti in modo automatizzato, secondo le regole che ti sei dato tramite le opzioni di Smart Routing.

N

Integrazione perfetta

Integrazione ideale con i sistemi SAP, ERP, CRM, Legacy-System, Microsoft 365 o Google Workspace. Grazie ai nostri open standard siamo in grado di integrare perfettamente i Retarus Fax Services nelle varie applicazioni gestionali o su cloud di quasi tutti i produttori. Per esempio, tramite webservice con RESTful-API o un’interfaccia standard e i protocolli SMTP, SFTP e HTTPS.

N

Monitoring e analisi

Puoi controllare costantemente lo stato delle tue comunicazioni fax tramite i dashbord e i report dettagliati di Retarus Enterprise Administration Services Portal su base web. Il monitoraggio può avvenire in tempo reale o impostando degli intervalli di tempo a piacere. La funzione può essere utilizzata per i fax in entrata e in uscita.

N

Trasparenza assoluta dei costi

Riduci i costi d’investimento e processo. Retarus permette di ridurre al minimo o eliminare completamente i costi per le infrastrutture telefoniche o dei fax, i software, gli aggiornamenti, l’amministrazione e la manutenzione. I modelli di fatturazione di Retarus si basano esclusivamente su prezzi a pacchetto o a pagina in base all'utilizzo (pay-per-use).

N

Sicurezza e conformità

Puoi fare affidamento su un livello di sicurezza massima. Retarus Enterprise Cloud con i suoi centri di elaborazione mondiali soddisfa i più rigidi criteri di sicurezza dati sia a livello nazionale che settoriale. Per esempio GDPR, PCI-DSS o HIPAA.

N

Crittografia PGP e X.509

Per garantire la sicurezza ottimale della tua comunicazione fax. Il collegamento con Retarus Enterprise Cloud avviene esclusivamente tramite una connessione codificata (TLS, VPN). Su richiesta Retarus firma e codifica anche i fax in entrata - in base al tipo di file tramite AES 256-bit, PGP o X.509.

N

Archiviazione a lungo termine

Osservanza dei requisiti specifici settoriali e di legge. Il servizio di archiviazione a lungo termine di Retarus permette di soddisfare i più rigidi requisiti legali in materia di sicurezza ed integrità dei dati della comunicazione fax.

N

Enterprise Level SLA

Puoi selezionare un Service Level Agreement in base alle esigenze specifiche della tua azienda sia in termini di qualità che di velocità. Gli API di Retarus Fax sono ideali tanto per le startup quanto per le medie aziende e i grandi gruppi industriali.
N

Servizio chiamata

Puoi ricevere i fax in tutto il mondo utilizzando un numero di fax locale. Retarus mette a disposizione numeri di fax in tutto il mondo e questi possono essere gestiti facilmente attraverso il portale EAS. Attraverso lo stesso portale è inoltre possibile gestire il trasferimento dei numeri di ricezione fax esistenti.

N

Assistenza e supporto

Assistenza impeccabile. Per qualsiasi domanda o personalizzazioni specifiche il Support Team di Retarus per gli Enterprise API Fax è a tua completa disposizione.

Prova gli API adesso!

Retarus Enterprise Cloud è una singolare infrastruttura a livello mondiale specializzata nella trasmissione affidabile per fax, e-mail, SMS ed EDI. Dal 1992 Retarus è sinonimo di comunicazione fax tecnologicamente all’avanguardia per le aziende. Anche tu puoi trarre vantaggio da quest’expertise, collegando la funzione fax al tuo software. In modo semplice. Veloce. Ed affidabile.