Skip to main content

Signature Write

Upload file for async sign

POST - /upload/async v1 con dati minimi

curl 'https://signature-write-api-test.agyo.io/api/v1/rpc/upload/async' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Authorization: Bearer ' \
  -H 'Connection: keep-alive' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Origin: https://apptest.teamsystemdigital.com' \
  -H 'Referer: https://apptest.teamsystemdigital.com/' \
  -H 'Sec-Fetch-Dest: empty' \
  -H 'Sec-Fetch-Mode: cors' \
  -H 'Sec-Fetch-Site: cross-site' \
  -H 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36' \
  -H 'X-App-Name: DIGITAL-SIGN' \
  -H 'X-App-Version: 2.25.49' \
  -H 'X-Correlation-Id: 4067db78-b818-4bdd-a017-c5428caa25a9' \
  -H 'X-Item-Id: 01234567890' \
  -H 'X-Request-Id: clyo4oowi0008356kojkiu99q' \
  -H 'X-User-Id: mail@mail.com' \
  -H 'accept-language: it' \
  -H 'sec-ch-ua: "Not/A)Brand";v="8", "Chromium";v="126", "Google Chrome";v="126"' \
  -H 'sec-ch-ua-mobile: ?0' \
  -H 'sec-ch-ua-platform: "Windows"' \
  --data-raw '{
	"documentType": "0000",
	"expiryDate": "23/07/2024",
	"fileContent": "inserire base64",
	"fileName": "file.pdf",
	"owner": {},
	"signatureMode": "pades",
	"signatureProcessName": "FEA remota",
	"signers": [
		{
			"mobile": "+393333333333",
			"email": "firmatario@mail.com",
			"fiscalCode": "ABCABC00X00X000X",
			"firstName": "nome",
			"lastName": "cognome",
			"signatureData": [
				{
					"coordsRegion": {
						"page": 1,
						"h": 0.05,
						"w": 0.2,
						"x": "0.03",
						"y": "0.02"
					},
					"fieldGroup": "fieldGroup",
					"positioningStrategy": "coords",
					"shortDescription": "signature",
					"longDescription": "signature",
					"signatureType": "otp",
					"textType": "signature",
					"optional": false
				}
			]
		}
	],
	"transmitterId": "01234567890"
}'

 

{
    "attachments": [],
    "areSignersOrdered": false,
    "autoSendCCT": false,
    "documentType": "0000",
    "expiryDate": "10/03/2021",
    "fileContent": "BASE64FILE"
    "fileName": "sample.pdf",
    "useSignatureTimestamp": false,
    "mainSignerId": "BSTCNA80A01I829U",
    "managerId": null,
    "metadata": {},
    "owner": {},
    "signatureMode": "pades",
    "signatureProcessName": "FEA remota",
    "signers": [
        {
            "mobile": "33325567864",
            "email": "prova@prova.com",
            "fiscalCode": "CRAPCC80A01I829L",
            "firstName": "Marco",
            "lastName": "Rossi",
            "signatureData": [               
                {
                    "coordsRegion": {
                        "page": 1,
                        "h": 0.05,
                        "w": 0.2,
                        "x": "0.53",
                        "y": "0.09"
                    },
                    "fieldGroup": "fieldGroup",
                    "positioningStrategy": "coords",
                    "shortDescription": "signature",
                    "longDescription": "signature",
                    "signatureType": "SecureCall",
                    "textType": "signature",
                    "optional": false
                }            
            ]
        }
    ],
    "transmitterId": "23785789985",
    "multipleDocumentSession": false,
    "sendSignedDocumentToMail": false
}

Testo

RadioButton

   			 	{
                    "coordsRegion": {
                        "page": 1,
                        "h": 0.05,
                        "w": 0.2,
                        "x": "0.53",
                        "y": "0.09"
                    },
                    "fieldGroup": "fieldGroup",
                    "positioningStrategy": "coords",
                    "shortDescription": "signature",
                    "longDescription": "signature",
                    "signatureType": "SecureCall",
                    "textType": "signature",
                    "optional": false
                }, {
                    "coordsRegion": {
                        "page": 1,
                        "h": 0.04,
                        "w": 0.05,
                        "x": "0.24",
                        "y": "0.43"
                    },
                    "fieldGroup": "Animale preferito",
                    "positioningStrategy": "coords",
                    "shortDescription": "Gatto",
                    "longDescription": "Animale preferito",
                    "signatureType": "SecureCall",
                    "textType": "radiobutton",
                    "optional": false
                }, {
                    "coordsRegion": {
                        "page": 1,
                        "h": 0.04,
                        "w": 0.05,
                        "x": "0.10",
                        "y": "0.43"
                    },
                    "fieldGroup": "Animale preferito",
                    "positioningStrategy": "coords",
                    "shortDescription": "Cane",
                    "longDescription": "Animale preferito",
                    "signatureType": "SecureCall",
                    "textType": "radiobutton",
                    "optional": false
                }

CheckBox

{
	"coordsRegion": {
		"page": 1,
        "h": 0.05,
        "w": 0.2,
        "x": "0.53",
        "y": "0.09"
	},
    "fieldGroup": "fieldGroup",
    "positioningStrategy": "coords",
    "shortDescription": "signature",
    "longDescription": "signature",
    "signatureType": "SecureCall",
    "textType": "signature",
     "optional": false
}, {
	"coordsRegion": {
    	"page": 1,
        "h": 0.04,
        "w": 0.05,
        "x": "0.36",
        "y": "0.71"
     },
     "fieldGroup": "fieldGroup",
     "positioningStrategy": "coords",
     "shortDescription": "checboxn1",
     "longDescription": "Vuoi accettare il contratto?",
     "signatureType": "otp",
     "textType": "checkbox",
     "optional": true
}

Allegati

 "attachments": [
        {
            "description": "carta d'identita'",
            "signerFiscalCode": "BNDNRC85M29G284G",
            "details": [
                {
                    "description": "fronte",
                    "optional": false
                },
                {
                    "description": "retro",
                    "optional": false
                }
            ]
        },
        {
            "description": "foto segnaletica",
            "signerFiscalCode": "MNNRFL96D21I829W",
            "details": [
                {
                    "description": "foto",
                    "optional": false
                }
            ]
        }
    ]
Start signature job

POST - /jobs/start v1

curl 'https://signature-write-api-test.agyo.io/api/v1/jobs/start' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Authorization: Bearer ' \
  -H 'Connection: keep-alive' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Origin: https://apptest.teamsystemdigital.com' \
  -H 'Referer: https://apptest.teamsystemdigital.com/' \
  -H 'Sec-Fetch-Dest: empty' \
  -H 'Sec-Fetch-Mode: cors' \
  -H 'Sec-Fetch-Site: cross-site' \
  -H 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36' \
  -H 'X-App-Name: DIGITAL-SIGN' \
  -H 'X-App-Version: 2.25.49' \
  -H 'X-Correlation-Id: feb72f3f-6c2f-46ac-b284-76ed33b77758' \
  -H 'X-Item-Id: 01234567890' \
  -H 'X-Request-Id: clyo7ykvx0012356kaa4eu6bu' \
  -H 'X-User-Id: mail@mail.com' \
  -H 'accept-language: it' \
  -H 'sec-ch-ua: "Not/A)Brand";v="8", "Chromium";v="126", "Google Chrome";v="126"' \
  -H 'sec-ch-ua-mobile: ?0' \
  -H 'sec-ch-ua-platform: "Windows"' \
  --data-raw ' {
  "hubId":"669672a810966672c74c5d88",
  "sendEmail":true
  }'

 

{
    "hubId": "60114f254a46625658841cd4",
    "sendEmail": true
}

Start signature job for multiDocuments
{
    "multiDocumentSessionId": "5f880d0a875f4f3d4574e767",
    "sendEmail": false
}
Send document to cct
{
    "hubId": "60362be0f27a686c982e6518"
}
Send documents to cct
{
    "hubIds": [
        "5ec24179e16fed0006ce7bf3",
        "5efdd0a537f55a00062db5d9",
        "5f008beb09d95c000672d688",
        "5f02b8c26b7afd0007d7344e"
    ]
}