FAX

Monopond’s SOAP-based API brings you the ability to send faxes programmatically from your applications. Using this API, you are able to both send a single document to a single destination and/or broadcast a single document to multiple destinations. With Monopond fax API, you can manage fax related parameters individually, such as:

– Enabling support for specific blocking filters
– Customising connection settings
– Scheduling options

Monopond offers extensive code libraries of different languages that would suit every developers’ needs. It can easily be integrated in any application and no hardware installation needed.

General Parameters and File Formatting

File Encoding

All files are encoded in the Base64 encoding specified in RFC 2045 – MIME (Multipurpose Internet Mail Extensions). The Base64 encoding is designed to represent arbitrary sequences of octets in a form that need not be humanly readable. A 65-character subset ([A-Za-z0-9+/=]) of US-ASCII is used, enabling 6 bits to be represented per printable character. For more information see http://tools.ietf.org/html/rfc2045 and http://en.wikipedia.org/wiki/Base64

Dates

Dates are always passed in ISO-8601 format with time zone. For example:

2012-07T19:27:23+08:00

API Examples

Sending a single fax message

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:v2="https://api.monopond.com/fax/soap/v2">
      <soapenv:Header>
         <wsse:Security soapenv:mustUnderstand="1"> 	
            <wsse:UsernameToken>    	
               <wsse:Username>username</wsse:Username>        	
               <wsse:Password>password</wsse:Password>   	
            </wsse:UsernameToken>
         </wsse:Security>
      </soapenv:Header>
	<soapenv:Body>
		<v2:SendFaxRequest>
		    <BroadcastRef>test-1</BroadcastRef>
		    <SendRef>test-1-1</SendRef>
		    <FaxMessages>
		    	<FaxMessage>          
			    	<MessageRef>test-1-1-1</MessageRef>
			    	<SendTo>61011111111</SendTo>
			    	<SendFrom>Test Fax</SendFrom>
			    	<Documents>                
			    		<Document> 
			    			<FileName>test.txt</FileName> 
			    			<FileData>VGhpcyBpcyBhIGZheA==</FileData>
			    		</Document>             	
			    	</Documents>
			    	<Resolution>normal</Resolution>           
			    	<Retries>0</Retries>
			    	<BusyRetries>2</BusyRetries>
			    </FaxMessage>   	
			</FaxMessages>
		</v2:SendFaxRequest>
	</soapenv:Body>
</soapenv:Envelope>

See the specifics at GitHub