RESTFul API
FillAnyPDF provides the API via REST (REpresentational State Transfer).
Requirements
- Developer Key.
- Ability to make GET and POST requests.
- Ability to parse returned XML.
How do I use it?
The service can be accessed by using the following URL:
https://www.fillanypdf.com/api/rest/{functionname}
Using POST or GET depends on the method/function you are calling. You must pass along your handshake on every request.
You can see the complete list of functions here
Using HTTP GET
To make a GET request, just use the service URL and add the parameters in the query string:
https://www.fillanypdf.com/api/rest/{functionname}?{par1=val1}[&par2=val2]….
Note: Some functions only allow calls using HTTP POST
Using HTTP POST
For POST just add the data to body of the request instead of the query string, and perform a HTTP POST to the same URL:
https://www.fillanypdf.com/api/rest/{functionname}
Security and POST vs GET
Typically in a REST service, the query string is used to send parameters to the service. In html terms, this request is done via the GET http verb. While the query string is also encrypted for a GET request over TLS/SSL there are places where that information might be registered. Such as:
- Server side logs
- History caches in browsers
- Bookmarks
- Bugs in the application/browser
However due to the high level of security involved with FillAnyPDF, all methods of the RESTful API can handle all parameters via POST, also the connection to our servers is always under SSL (https) so the content of a HTTP POST is always encrypted, increasing security.
Parsing the XML result
After making a call to any FAP Services operation, you will get an XML response. A response will like like the following:
<ServiceResultOfBoolean xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <Failed>false</Failed> <Result>true</Result> </ServiceResultOfBoolean>