Action specifications can include a list of possible errors and error details. Each top-level error that an authentication API request returns can include one or more error detail objects underneath it.
Typically, in the API specification, your only top-level error will be
CommonErrorSpec.VALIDATION_ERROR. However, you can include error
detail specifications that can appear under that top-level error.
TemplateRenderAdapterdefines the specification for the
public final static AuthnErrorDetailSpec INVALID_ATTRIBUTE_NAME = new AuthnErrorDetailSpec.Builder() .code("INVALID_ATTRIBUTE_NAME") .message("An invalid attribute name was provided.") .parentCode(CommonErrorSpec.VALIDATION_ERROR.getCode()) .build();
The error detail specification must reference the error code of its parent top-level error. This ensures that the authentication API Explorer correctly represents the error information.
INVALID_ATTRIBUTE_NAME is an example of an error that would be useful for API
client developers but not for end users.
For more information about defining user-facing errors, see Error messages and localization.