2. Bắt đầu quá trình ký kết

Danh tính ký và txId thu được trong bước trước cần được chuyển trong lệnh gọi API tiếp theo cùng với một hoặc nhiều tài liệu sẽ được ký.

PUT http://localhost:8080/v2/signature/request

Tiêu đề

Name	Value
Content-Type	multipart/form-data

Body

Name	Description
digestAlgorithm	SHA256
signIdentityId	ckqtokgre4o5mrk4bajtk413ui
txId	90ca005cfb4d4827b1247889166b72fe
file	file1.pdf file2.pdf
sigProp	{ "signPropDetail": [ { "fileName": "file1.pdf", "signInfo": "1:50, 50, 200,200]" }, { "fileName": "file2.pdf", "signInfo": "1:[50,50,200,200]" } ] }

Phản ứng

200

{
```
https://stg-id.uaepass.ae/trustedx-authserver/oauth/hsign-as?response_type=code&client_id=sandbox_stage&redirect_uri=http%3A%2F%2Flocalhost%3A8080%2Fv2%2Fsignature%2Ftoken&scope=urn:uae:digitalid:backend_api:hash_signing urn:safelayer:eidas:sign:identity:use:server&state=1434459749&digests_summary=npBScEri0PAqJ8yWz11jvcjFOlzVkDijlM-osjrX98k%3D&digests_summary_algorithm=SHA256&sign_identity_id=ckqtokgre4o5mrk4bajtk413ui
```
}

400

{
"error": "Invalid request"
}

Cung cấp các giá trị dưới đây cho tham số "signProp" trong lệnh gọi API. Các giá trị phải được điều chỉnh cho phù hợp theo các tệp.

{
"signPropDetail": [
{
"fileName": "sample1.pdf",
"signInfo": "1:[50, 600, 200, 100]"
},
{
"fileName": "sample2.pdf",
"signInfo": "1:[50, 600, 200, 100]"
}
]
}

Mô tả các thông số trong nội dung yêu cầu trên:

Filename	Tên của tệp cần được ký. Nó phải giống hệt như cái đã chọn.
signInfo	Số trang và vị trí ký trên trang được chỉ định. 2 giá trị đầu tiên (50.600) chỉ định các giá trị cho tọa độ X, Y góc dưới bên trái và hai giá trị 200.100 khác) đại diện cho tọa độ X, Y góc trên bên phải.

txId (bắt buộc)	ID giao dịch để ký yêu cầu. Lưu ý: ID giao dịch chỉ có hiệu lực trong 10 phút và hoạt động sẽ kết thúc trong cùng khoảng thời gian.
digestAlgorithm(bắt buộc)	Thực thể có thể sử dụng một trong các thuật toán tiêu hóa từ bên dưới theo yêu cầu của chúng: SHA256 SHA384 SHA512
signIdentityId (bắt buộc)	ID chứng chỉ đủ điều kiện của người dùng
tập tin (bắt buộc)	Tệp PDF sẽ được ký
signProp	Như mô tả ở trên

Mẫu yêu cầu người đưa thư

Lệnh curl mẫu

curl --location --request PUT 'http://localhost:8080/v2/signature/request'
--header 'Content-Type: multipart/form-data'
--form 'digestAlgorithm="SHA256"'
--form 'signIdentityId="49o09dt4v47lvd2r14tesod0at"'
--form 'txId="4f1068dbe3f64aefa45ada9555c9ba0b"'
--form 'file=@"/C:path to file/file1.pdf"'
--form 'file=@"/C:path to file/file2.pdf"'
--form 'sigProp="{
"signPropDetail": [
{
"fileName": "file1.pdf",
"signInfo": "1:50, 50, 200,200]"

},
{
"fileName": "file2.pdf",
"signInfo": "1:[50,50,200,200]"
}
]
}"'

1. Bắt đầu quá trình ký

3. Ký tài liệu PDF

Was this helpful?

Thank you!