Messente avatar logo

Verification API Documentation

Service Setup

When starting with Verification API you will first need to register your Service to get a unique ServiceID that will be later used to add and verify your users.

You may have multiple separate web services using the same Messente account, therefore you can create multiple Services and receive multiple ServiceID's in the process.

Request to register a service will be made to the following URL:
POST https://api.verigator.com/v1/service/service
Request headers
HTTP headerDescriptionRequired
Content-Typeapplication/jsonYes
Acceptapplication/jsonYes
X-Service-AuthRefer to authentication section on how to authenticate your API calls with Messente API username and passwordYes
Request body (JSON encoded)
KeyDescriptionRequired
fqdnFully Qualified Domain Name
Example: coffeeshop.com or dashboard.service.com
Yes
nameName of your service, that will appear as the issuer in the Verigator app.
Example: CoffeeShop
Yes
Response body (JSON encoded)
KeyValue
idNewly created ServiceID. You will need to store this in your Verigator API configuration.
Example: 81213bfd-b690-499e-b9d2-8754cb1550e8
nameName of the Service as provided in request body.
Example: CoffeeShop
ctimeDatetime of the created service in RFC 3339 specification.
Example: 2017-07-06T13:12:03.141Z
HTTP Response Codes
STATUS codeValueDescription
201CreatedService successfully created
401Authentication required
Missing authentication headers (X-Service-Auth)
403ForbiddenForbidden request
404Not found
409ConflictService already exists
422Invalid dataInvlalid request body - check the format and if it was correctly JSON encoded

EXAMPLES

from messente.verigator.api import Api

# initialize api
api = Api("username", "password")

# create your service
service = api.services.create("http://example.com", "service_name")
// Initialize the Verigator API with your Messente API credentials
Verigator verigator = new Verigator(API_USERNAME, API_PASSWORD);

// Create a Service resource for your service, you do this only once!
Service service = verigator.createService("Some example service", "www.example.com");

// Store the returned Service id in your server's configuration files
String serviceId = service.getServiceId();