Vai al contenuto

Get disposable contract with eID assertion

Richiesta

Retrieves disposable contract documents (Mod_NAMCA22D) using an eID assertion. Returns contract PDF/TXT, privacy document URL (Mod_NAMGDPR03D), and T&C document URL (Mod_NAMCA01D). The contract is pre-filled if eIDAssertionHolder and contacts are provided. See getDisposableContractWitheIDAssertion and How to enroll with eID assertion.

Sicurezza
basicAuth and sslCertificate
Percorso
lraIdstringobbligatorio

Local Registration Authority (LRA) identifier.

Corpoapplication/jsonobbligatorio
eIDAssertionHolderobject(DisposableeIDAssertionHolder)

eID assertion holder data. If provided, the contract will be pre-filled with holder information.

certobject(DisposableCertificate)obbligatorio

Certificate configuration. Specifies certificate type and options.

contactsobject(DisposableContacts)

Contact information. If provided, the contract will be pre-filled with contact details.

languageCodeArray of stringsobbligatorio

Languages of the document. ISO 639-1 alpha-2 codes. You can specify multiple values.

Esempio:
[ "EN" ]
docTypesArray of integers, (int32)obbligatorio

Document types. Allowed values: 1 (PDF), 2 (TXT). You can specify multiple values.

Esempio:
[ 1 ]
countrystring^[A-Z]{2}$

Country code where the final user is located. ISO 3166-1 alpha-2 code. Optional — if not specified, the default template for the specified languageCode is returned. Required when a LRA needs contracts in several languages but for different legislations (e.g., French contract for France vs. French contract for Belgium).

Esempio:"IT"

Get contract with IT-EIDNAMIRIAL eID assertion. The contract will be pre-filled with holder and contact information.

curl -i -X POST \
  -u '<username>:<password>' \
  'https://lean.namirialtsp.com/RAWS_DISPOSABLE/api/document/{lraId}/getDisposableContractWitheIDAssertion' \
  -H 'Content-Type: application/json' \
  -d '{
    "eIDAssertionHolder": {
      "country": "IT",
      "eIDType": "EIDNAMIRIAL",
      "assertion": "eyJnaXZlbl9uYW1lIjoiTWFyaW8iLCJmYW1pbHlfbmFtZSI6IlJvc3NpIiwicGVyc29uX2lkZW50aWZpZXIiOiJUSU5JVC1SU1NNUkE4MEEwMUg1MDFVIiwiYmlydGhfZGF0ZSI6IjE5ODAtMDEtMDEiLCJkb2NfdHlwZSI6Ik5BVElPTkFMX0lERU5USVRZX0NBUkQiLCJjb3VudHJ5IjoiSVQiLCJycF9uYW1lIjoiTmFtaXJpYWwgVGVzdCBSUCIsInJwX2lkIjoidGVzdC1ycC0wMDEiLCJvcmlnaW5hbF9hc3NlcnRpb24iOiJiYXNlNjRfZW5jb2RlZF9zYW1sX2Fzc2VydGlvbl9oZXJlIiwiaWF0IjoxNzA5NTY4MDAwfQ=="
    },
    "contacts": {
      "mobile": "+390000000000",
      "email": "example@example.com"
    },
    "cert": {
      "type": "DISPOSABLE",
      "password": "Password01",
      "securityCode": "Security01",
      "withoutUsageLimitLRA": false
    },
    "languageCode": [
      "EN"
    ],
    "docTypes": [
      1
    ]
  }'

Risposte

Contract documents retrieved successfully. Returns an array of contract documents (Mod_NAMCA22D) with privacy and T&C links. The contract is pre-filled if eIDAssertionHolder and contacts are provided.

Corpoapplication/json
Array [
languageCodestring

Language of the document. ISO 639-1 alpha-2 code.

Esempio:"IT"
docTypesinteger, (int32)

Document type. 1 = PDF, 2 = TXT.

Esempio:2
docstring, (binary)

Base64-encoded document (Mod_NAMCA22D). Pre-filled with holder data if disposableHolder, disposableContacts and disposableDoc were provided in the request.

checkBoxesArray of strings

List of checkbox label strings to be displayed to the user for acceptance.

]
Risposta
[ { "languageCode": "IT", "docTypes": 2, "doc": "string", "privacy_link": "https://docs.namirialtsp.com/documents/Mod_NAM_GDPR03D_ITA_IT.pdf", "termsAndConditions_link": "https://docs.namirialtsp.com/documents/Mod_NAM_CA01D_ITA_IT.pdf", "checkBoxes": [ … ] } ]