API

Purpose of this page

This page describes how users can leverage the Invisible Collector’s API to develop an integration between their information system and Invisible Collector.

API

The Invisible Collector’s REST API provides programatic access to read and write Invisible Collector’s data which includes among other things:

All information exchanged is JSON based and through TLS for security reasons.

We already provide client libraries in some programming languages to reduce the integration time. All of them are available on Github with instructions on how to use them.

Data Model

Invisible Collector models the information around the exchange of documents between 2 entities: companies and customers. The exchanged documents can be either one of:

Assuming a relational model you can say that:

Returned Server Errors format

The errors returned by the server have the following JSON format:

{ "code": 404, "message": "error message" }

Some server errors may have have additional name/value pairs, such as the 409 status code for conflicting model fields:

{ "code": 409, "gid": "0d3987e3-a6df-422c-8722-3fde26eec9a8", "message": "conflicting field" }

Error message body

Attribute Type Presence Description
code number Always The HTTP error status code.
message string Always The HTTP error message.
gid string HTTP 409 The id of the conflicting model.

Feedback

If you have a question that needs an answer, please contact support.