Quick Start

Get your API keys

All API calls require authentication. To obtain an authentication token you will require a username, password, client id and secret (this was emailed to you).

Any request that doesn't include an API key will return an error.

You can generate an API key from your Dashboard at any time or by contacting us through the following link:

Support and Contact Information

Create Token

Create Token

Example Request

Bellow you will find some example requests

Postman

POST: https://dmsworkspace-sso-pre.dmsworkspace.com/realms/dmsworkspace/protocol/openid-connect/token

Select x-www-form-urlencoded in the Body tab

Populate the client_id, client_secret, username, password and grant_type

Hit Send to get your Bearer Token 

Make your first request

To make your first request, send an authenticated request to the id-recognition endpoint. This will create an document id, passport or driving license scan, which will produce a response with all the data contained in any of the documents mentioned above.

Create id-recognition scan

POST https://dmsworkspace-gateway-backend-int.dmsworkspace.com/OCR-SCANNER-BACKEND/v1/id-recognition

Request Type: form-data

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
channel*	string	Your sales channel (WEB, APP or any other of your choice)
file*	multipart/file	Binary of the file containing the document id, passport or driving license
reference*	string	Custom value to identify scans later on the platform (Contract Number, etc)

Here you can find more information regarding api expected responses

id-recognition

Take a look at how you might call this method via postman: