Docmail hybrid mail. Online print, personalisation and post for 25p*.
The low cost, easy, online way to create, personalise, print and mail all your post!
Save even more time by integrating docmail into your own application!
Docmail now has a web service and API (Application Programming Interface) available so you can send a single letter, or a mailing from a click of a button within your own application.
Introducing the Docmail API
The API is a SOAP-based webservice allowing the creation, proofing and confirmation of orders for mailings and single letters. As with the website, Documents (PDF or Word files) are submitted, along with address(es).
Through the API, addresses can be submitted either in the same form as to the website (CSV, XLS files), or in mailing objects populated in code. The Documents are most commonly submitted as byte arrays.
Once the order has been created, a PDF proof is returned and can be reviewed by the end user prior to their confirmation of the order.
Payment through the API is achieved via Top-Up credit on the customer Account, or for large volume users, payment on invoice may be available (subject to volume and regularity of orders).
Examples in the API documentation are based around Microsoft Visual Basic .Net © code and the Microsoft Visual Studio 2008 © development environment.
Web Service Help Guide
Webservice User Setup Guide
Simple API
While the full version of the API is very flexible and easy to set up with a .Net environment, we found that in some languages (particularly scripting languages like Perl and PHP), some of the more complex objects were harder to work with.
To improve this, we created the Simple API, which wraps the full API providing a more script-friendly interface. It contains most of the functionality of the Full API, but uses more simple types and takes the username & password as parameters on each call, in place of the custom authentication headers in the Full API.
We’ve provided some simple examples of Coding with the API’s in various languages to help you on your way.
Code Examples
.Net – Full API:
Java (NetBeans)
- NetBeans Webservices Guide
- Full API: Main_API_Example.java.txt
- Simple API: Simple_API_Example.java.txt (slightly easier to code with in Java)
PHP – Simple API:
Perl – Simple API:
Our Docmail Express page is written using the Simple API and Perl. Docmail Express offers a simplified interface for submitting Docmail orders & illustrates how the API could be used to integrate Docmail into another website.
Useful Links
Docmail Home
Docmail Signup
Docmail Login
Docmail API Forum
Docmail Blog
Docmail Listing on ProgrammableWeb
Docmail for:
