HTTP API Request Authentication

API endpoint

Verigator API requests are made to following server:

https://api.verigator.com/

Authentication

Authentication is done by setting HTTP header "X-Service-Auth" to your Messente API username and password concatenated with semicolon like this:

X-Service-Auth: messente-api-username:messente-api-password

Request and response body

All request and response bodys for the API calls are JSON encoded strings according to the specification.

Response HTTP status codes

API call responses have status codes according to REST specifications.
Always set Accept and Content-Type headers to application/json as well.
Only 2XX response codes indicate successful response.

Example request

$ curl -X POST \
   --header 'Content-Type: application/json' \
   --header 'Accept: application/json' \
   --header 'X-Service-Auth: uXXwRLJOaCifV:oA5rVSvslkcoXK' \
   --data '{"method": "totp"}' \
   'https://api.verigator.com/v1/service/402339fa-624a-11e7-907b-a6006ad3dba0/users/57166678-624a-11e7-907b-a6006ad3dba0/auth'