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. |
