Connector Endpoints
Service API
Additional endpoints to be implemented on connector side to improve communication between Salt Edge PSD2 Compliance Solution and Connector.
Errors Notify
This endpoint is responsible for receiving validation errors of responses which Connector sends to Salt Edge PSD2 Compliance Solution
CURL
curl -i \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJkYXRhIjp7InJlcXVlc3QiOnsibWV0aG9kIjoiZGVsZXRlIiwidXJsIjoiaHR0cHM6Ly91c2VyLndpbGwuYmUvcmVkaXJlY3RlZC9oZXJlIiwiaGVhZGVycyI6e319LCJlcnJvciI6eyJlcnJvcl9tZXNzYWdlIjoic29tZXRoaW5nIHdlbnQgd3JvbmciLCJlcnJvcl9jbGFzcyI6IkludGVybmFsUHJvdmlkZXJFcnJvciJ9fSwiZXhwIjoxNzMyNTEwMzcwLCJpc3MiOiJwcmlvcmEuc2FsdGVkZ2UuY29tIn0.FtsDqnpT3MVK4hbrsBm6CRoALJwk9IqVdovmSenhJSOi047LspDu2jIA-MIqWb_2UFOKvYjeqE_bbikKk8tcdP0YBDdZgI2A1T-McGQKSgn8zp3IaeEz5DPuMsPmBpJTGp0G68Ebx_etcOUOzgFznTsPEXN22TRQ3_0k903tsQi1pNzx5EBBzCTYC2fe4PrTbfWBohfA9hQrilSJR9v9BQg4bg66bgqNAc4yyqlcy6gPeb0aCzjlCFab_S_mCwvgbbF_dbzvrx0Xu-Lxa7rTpzUmvJ8msFVNI0khp5Niv1-Pfnqg-YVjEL5csLCnJbjgHuQy-ouJ_R-Oclznv7kAIQ" \
-H "Access-Token: b2077c5c020a5e262767aac63fdbc75fd64461afc660784fbc3451766f586bb4836e3405007c2caf497a1125ba58fb49be65b3c352285dea68328aded84e2f91" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Client-Id: 685" \
-X POST "https://your.connector.url/api/priora/v2/errors"Example of request parameters
{"data":{"request":{"method":"delete","url":"https://user.will.be/redirected/here","headers":{}},"error":{"error_message":"something went wrong","error_class":"InternalProviderError"}},"exp":1574093209}
Request
POST
https://your.connector.url/api/priora/v2/errors
Headers
| Header | Type | Description |
|---|---|---|
Authorization
|
string, required |
JSON Web Token containing payload, signed using RSA256 and application.private_key.
|
Access-Token
|
string, optional | The token which is created by a connector as a result of successful authentication. |
Accept
|
string, required | Media type that is acceptable for the response. Allowed values: application/json |
Content-Type
|
string, required | The media type of the body of the request. Allowed values: application/json |
Client-Id
|
integer, required | TPP application identifier in Salt Edge PSD2 Compliance. |
Consent-Id
|
integer, optional | ID of the corresponding consent object. |
Unpacked Request Authorization
Response headers
| Header | Type | Description |
|---|---|---|
Retry-After
|
integer, optional | Amount of time in seconds after which Salt Edge PSD2 Compliance Solution resends the previously failed request. |
Response
Upon successful request, 200 status code with an empty JSON "{}" should be returned.
Health Check Monitoring New
This endpoint is responsible for receiving regularly health check requests and quickly return the operational status of the Connector service.
CURL
curl -i \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Client-Id: Saltedge" \
-X GET "https://your.connector.url/api/priora/v2/health"Example of request parameters
{"data":{},"exp":1574093210}
Example of response
{"status":"UP"}
Request
GET
https://your.connector.url/api/priora/v2/health
Headers
| Header | Type | Description |
|---|---|---|
Accept
|
string, required | Media type that is acceptable for the response. Allowed values: application/json |
Content-Type
|
string, required | The media type of the body of the request. Allowed values: application/json |
Client-Id
|
string, required | Salt Edge identifier of application. Allowed values: Saltedge |
Consent-Id
|
integer, optional | ID of the corresponding consent object. |
Unpacked Request Authorization
Response headers
| Header | Type | Description |
|---|---|---|
Retry-After
|
integer, optional | Amount of time in seconds after which Salt Edge PSD2 Compliance Solution resends the previously failed request. |
Response
Upon successful request, 200 status code should be returned.