Dfns API Documentation
Ask or search…
K

API Errors

Common Errors

400 - Bad Request

Nonce header is missing or invalid
All requests need to include an X-DFNS-NONCE header. See Request Headers for more information.
{
"error": {
"message": "request nonce is missing or invalid",
}
}
Nonce already used
The nonce specified in X-DFNS-NONCE was already used. The nonce should be uniquely generated for every request.
{
"error": {
"message": "request nonce has already been used"
}
}
User Action Signature already used
The User Action Signature specified in X-DFNS-USERACTION was already used. User action signatures can only be used once.
{
"error": {
"message": "user action has already been used"
}
}

401 - Unauthorized

Caller not authenticated
All requests to an authenticated endpoint need to include a JWT in the Authentication header. See Request Headers for more information.
{
"error": {
"message": "Not Authorized."
}
}

403 - Forbidden

Caller not authenticated
Caller does not have access to the resource or endpoint
{
"error": {
"message": "CustomerEmployee us-24vwa-92s33-8tvqi1dg0a95megt is not authorized to perform operation (Auth:Apps:Update)"
}
}
User Action Signature missing or invalid
Mutating requests need to include a valid User Action Signature in the X-DFNS-USERACTION header. See User Action Signing for more information.
{
"error": {
"message": "user action signature is missing or invalid"
}
}

500 - Internal Server Error

Internal Server Error
This is an unexpected error. Please try your request again. If the call continues to fail, please contact support.
{
"error": {
"message": "Internal Server Error"
}
}

Application Management Errors

Errors specific to the Application Management endpoints.

400 - Bad Request

Application cannot modify its own state
The application being deactivated needs to be different then the application specified in X-DFNS-APPID.
{
"error": {
"message": "application cannot modify its own state"
}
}

404 - Not Found

Application not found
The specified application does not exist in the database.
{
"error": {
"message": "application not found"
}
}

Credential Management Errors

Errors specific to the Credential Management endpoints.

Delegated Authentication Errors

Errors specific to the Delegated Authentication endpoints.

User Login Errors

Errors specific to the User Login endpoints.

Personal Access Token Management Errors

Errors specific to the Personal Access Token Management endpoints.

User Registration Errors

Errors specific to the User Registration endpoints.

Service Account Management Errors

Errors specific to the Service Account Management endpoints.

User Action Signing Errors

Errors specific to the User Action Signing endpoints.

User Management Errors

Errors specific to the User Management endpoints.

User Recovery Errors

Errors specific to the User Recovery endpoints.
Last modified 16d ago