Introduction

To obtain the payload of a specific document, the Thinksurance Public API V1, denoted as "the API," offers a specialised endpoint. This endpoint allows consumers to retrieve a document by its identifier (hash) and acquire its complete payload as a base64-encoded data.

Endpoint

To access the specific document, consumers must initiate an HTTP POST request to the /api/ipn/documents/{:documentId} endpoint. The documentId parameter represents an unique identifier of the document in question. As essential components of the JSON payload within the body of the request, consumers are required to include the bToken (functioning as the broker identifier).

Action name

get document

HTTP path

/api/ipn/documents/{:documentId}

documentId - an unique identifier of the requested document.

HTTP method

POST

Attributes of the HTTP request

HTTP Request Header
Authorization	string	required	A security token provided from Authentication endpoint. Required to provide as a Bearer Token (in format: “Bearer {{token}}“).
JSON Body
bToken	string	required	An unique identifier of the broker.

Attributes of the HTTP response

Success response
JSON array of objects containing:
Base64 encoded content of the document.
Failed response
error	string	required	It contains a reason for the failed request.

Examples

This section shows examples of different HTTP requests and responses associated with the endpoint /api/ipn/documents/{:docuementId}.

HTTP Request

# HTTP POST
# https://ipn.dev.thinksurance.de/api/ipn/documents/<some ID>
#
# HTTP headers
# 'Content-Type': 'application/json'
# 'Accept': 'application/json'
# 'Authorization': 'Bearer <some long string value>'
# 
{doc
  "bToken": "some encrypted string"
}

Successful HTTP Response

# HTTP 200 status code
# 'Content-Type': 'text/pdf'
Base64 encoded payload

Failed HTTP Response

# HTTP 200 status code
# 'Content-Type': 'application/json'
{
  "error": "API User is not existing or deactivated."
}

Get Document

Introduction

Endpoint

Attributes of the HTTP request

Attributes of the HTTP response

Examples