This method checks the validity of the data:
- if parameters match all the mandatory fields as described in data objects reference
- if parameters match the allowed values as described in data objects reference
- if the LRA is enabled to issue disposable certificates
- if the limitation of use (LoU) language (if specified) is available in the LRA configuration — see
limitationOfUse.language - If the
otpType = SMSby default the same phone number can be used only by 1 holder in a time range of 30 days. - if the
otpType=EMAILby default the same email can be used only by 1 holder in a time range of 30 days. - if the
otpType=WHATSAPPby default the same phone number can be used only by 1 holder in a time range of 30 days. - if the
otpType=NO_OTPthe LRA has to be authorized
For the full technical reference, see the OpenAPI specification.
POST /api/certificate/{lraId}/checkData| Name | Required | Description |
|---|---|---|
Content-Type | Yes | Must be application/json. |
Authorization | Yes | Basic Auth credentials. |
| Parameter | Type | Required | Description |
|---|---|---|---|
lraId | integer | Yes | LRA identifier. |
| Parameter | Type | Required | Description |
|---|---|---|---|
disposableHolder | object | Yes | DisposableHolder object. |
disposableContacts | object | Yes | DisposableContacts object. |
disposableDoc | object | Yes | DisposableDoc object. Not required for specific categories, see more details into the section. |
disposableCert | object | Yes | DisposableCertificate object. |
identification | object | No | DisposableIdentification object. |
disposableAddress | object | No | DisposableAddress object. |
Standard enrollment:
{
"disposableHolder": {
"birthCity": "Ancona",
"birthDate": "2000-11-09",
"citizenShip": "IT",
"firstName": "Mario",
"identificationCode": "RSSMRA80A01H501U",
"identificationCountry": "IT",
"identificationType": "ITALIAN_TAX_CODE",
"lastName": "Rossi"
},
"disposableContacts": {
"email": "user@example.com",
"mobile": "+390000000000"
},
"disposableDoc": {
"documentExpirationDate": "2029-11-09",
"documentIssuer": "Comune di Ancona",
"documentIssuerCountry": "IT",
"documentIssuerDate": "2019-08-22",
"documentNr": "AB1234567",
"documentType": "CI"
},
"disposableCertificate": {
"fullData": false,
"otpType": "SMS",
"password": "YOUR_PASSWORD",
"securityCode": "YOUR_SECURITY_CODE",
"type": "DISPOSABLE"
},
"identification": {
"identificationType": "DEVISU"
},
"disposableAddress": {
"ccat": "A271",
"city": "SENIGALLIA",
"country": "IT",
"province": "AN",
"street": "Via Roma 1",
"zip": "60019"
}
}With multi-language limitation of use:
{
"disposableHolder": {
"birthCity": "Ancona",
"birthDate": "2000-11-09",
"citizenShip": "IT",
"firstName": "Mario",
"identificationCode": "RSSMRA80A01H501U",
"identificationCountry": "IT",
"identificationType": "ITALIAN_TAX_CODE",
"lastName": "Rossi"
},
"disposableContacts": {
"email": "user@example.com",
"mobile": "+390000000000"
},
"disposableDoc": {
"documentExpirationDate": "2029-11-09",
"documentIssuer": "Comune di Ancona",
"documentIssuerCountry": "IT",
"documentIssuerDate": "2019-08-22",
"documentNr": "AB1234567",
"documentType": "CI"
},
"disposableCertificate": {
"fullData": false,
"otpType": "SMS",
"password": "YOUR_PASSWORD",
"securityCode": "YOUR_SECURITY_CODE",
"type": "DISPOSABLE",
"limitationOfUse": {
"withoutUsageLimitLRA": false,
"language": "en"
}
},
"identification": {
"identificationType": "DEVISU"
},
"disposableAddress": {
"ccat": "A271",
"city": "SENIGALLIA",
"country": "IT",
"province": "AN",
"street": "Via Roma 1",
"zip": "60019"
}
}200 — Success
Empty bodyErrors: Check here the main errors triggered.