Vai al contenuto

Enroll disposable certificate

Richiesta

Enrolls a disposable certificate for the holder. Returns certIdOtp and deviceCode required by sendOtp and validate. See enroll.

Sicurezza
basicAuth and sslCertificate
Percorso
lraIdstringobbligatorio

Local Registration Authority (LRA) identifier.

Corpoapplication/json
disposableHolderobject(DisposableHolder)obbligatorio
disposableContactsobject(DisposableContacts)

Required if otpType=SMS (provide mobile) or otpType=EMAIL (provide email).

disposableDocobject(DisposableDoc)obbligatorio

Identity document information.

Not required if one of the following conditions is true:

  • DisposableIdentification.identificationType is AML
  • DisposableHolder.identificationType is one of: PASSPORT, PERSONAL_NUMBER, NATIONAL_IDENTITY_CARD, DRIVING_LICENSE, RESIDENCE_PERMIT, RESIDENCE_PERMIT_TEMP, EMBASSY_DOCUMENT
disposableCertificateobject(DisposableCertificate)obbligatorio
identificationobject(DisposableIdentification)
disposableAddressobject(DisposableAddress)
buReIdstring, <= 255 characters

Business Relation Identifier for One Platform integration.

Enroll with otpType=SMS. Requires disposableContacts.mobile in E.164 format.

curl -i -X POST \
  -u '<username>:<password>' \
  'https://lean.namirialtsp.com/RAWS_DISPOSABLE/api/certificate/{lraId}/enroll' \
  -H 'Content-Type: application/json' \
  -d '{
    "disposableHolder": {
      "firstName": "Mario",
      "lastName": "Rossi",
      "identificationType": "ITALIAN_TAX_CODE",
      "identificationCode": "RSSMRA80A01H501U",
      "identificationCountry": "IT",
      "birthDate": "1980-01-01",
      "birthCity": "Roma"
    },
    "disposableDoc": {
      "documentType": "CI",
      "documentNr": "AA0000000",
      "documentIssuer": "Comune di Roma",
      "documentIssuerDate": "2020-01-01",
      "documentIssuerCountry": "IT",
      "documentExpirationDate": "2030-01-01"
    },
    "disposableCertificate": {
      "password": "Password01",
      "securityCode": "Security01",
      "type": "DISPOSABLE",
      "otpType": "SMS"
    },
    "disposableContacts": {
      "mobile": "+390000000000"
    }
  }'

Risposte

Issued disposable certificate. See DisposableIssued.

Corpoapplication/json
certstring, (binary)

Base64-encoded DER certificate.

certTypestring(DisposableType)

Certificate type, as specified in disposableCertificate.type.

Enum:"DISPOSABLE""DISPOSABLE_30_DAYS""LONG_LIVED""DISPOSABLE_FEA"
certUsageLimitstring

Limitation of use (LoU) text embedded in the certificate.

certSerialNumberstring

Certificate serial number (hex).

Esempio:"60F2373BFCEB569E"
certIdOtpinteger or null, (int32)

OTP certificate identifier. Pass this value to sendOtp and validate. null if otpType=NO_OTP or otpType=EXTERNAL_OTP.

Esempio:1234567
deviceCodestring

Device code associated with the issued certificate. Pass this value to sendOtp and validate.

Esempio:"RHIDP0000000000000"
Risposta
{ "cert": "string", "certType": "DISPOSABLE", "certUsageLimit": "string", "certSerialNumber": "60F2373BFCEB569E", "certIdOtp": 1234567, "deviceCode": "RHIDP0000000000000" }