This article describe how to control your mailboxes via its native REST HTTPS API
Parseur API Authentication
Parseur API uses a token-based authentication.
You will find your API Token Key in your Account Overview .
For clients to authenticate, the token key should be included in the Authorization HTTP header. The key should be prefixed by the string literal "Token", with white space separating the two strings. For example:
Authorization: Token 1234d45678c90bcf1234fe123ddae4aabbc6abcd
Unauthenticated responses that are denied permission will result in an HTTP 403 Unauthorized response with an appropriate WWW-Authenticate header. For example:
The curl command line tool may be useful for testing token authenticated APIs. For example:
curl -X GET https://api.parseur.com/ -H "Authorization: Token <enter-your-token-here>"
As per standard REST protocol:
- You can list your mailboxes with a GET request on /parser
- You can create a mailbox with a POST request on /parser
- You can retrieve a mailbox with a GET request on /parser/:mailbox_id
- You can update a mailbox with a PUT or POST request on /parser/:mailbox_id
Manage Documents in a mailbox
- To send a document via API, check out this article
- You can list your documents in a given mailbox with a GET request on /parser/:mailbox_id/document_set
- You can retrieve a document and parsed result with a GET request on /document/:document_id
Manage Templates in a mailbox
- You can list your templates in a given mailbox with a GET request on /parser/:mailbox_id/template_set
Manage parsed data
- Parseur can send parsed data in real time to your server via its Webhook feature. Check out this article about using webhooks with Parseur.
All GET request that returns a list of documents, templates and mailboxes support the pagination by appending a page option to the URL
For example: /parser?page=12
Do more with the API
This article just lists the most common use cases of using out API. There is much more you can do, feel free to ask us for more details!