Authorization

In order to send a message or to request a eID-authentication you need to authenticate yourself using the credentials given by Zignsec.

Authorization	This header parameter is the personal access token you received from ZignSec during the registration process. Example: `Authorization: 12345678-e2a2-4968-b651-5352305c9fb0`	Required
Content-Type	Specifies the media type of the request body data. Set to `application/x-www-form-urlencoded`. for post data and `application/json` if json object. Example: `Content-Type: application/x-www-form-urlencoded`	Required
Host	Use test.zignsec.com for test enviroment and api.zignsec.com for production enviroment. Example: `api.zignsec.com`	Required

General REST call format, [service] and [method] needs to be enabled for user ‘00000000-e2a2-4968-b651-5352305c9fb0’:

            POST https://test.zignsec.com/v2/[service]/[method] HTTP/1.1
Authorization: Your access token
Content-Type: application/x-www-form-urlencoded
Host: test.zignsec.com
Content-Length: 71

General configuration

To get started with any ZignSec integration you need to configure a few things. This is most easily done by telling us the below configuration options. Please note that you can set up multiple configurations for the same account. If that is the case, you will need a configid to use when calling the API.

Return URL	This is the URL ZignSec sends back to the browser via the “redirect” when all is done. You can also put any request in the “target” field.
Webhooks	These are server-to-server calls that occur at various events. The easiest way to get started is to provide an URL. For this service only “api.success” is interesting. Read more about this in the section Webhooks.