3. Ký tài liệu PDF

Bước 1. Nhận mã thông báo truy cập:

URL phản hồi thu được từ lệnh gọi API trước đó cần được gọi trong trình duyệt để lấy mã thông báo truy cập. Người dùng cần nhập mật khẩu ký đủ điều kiện trong bước này để lấy mã thông báo truy cập.

Phản hồi mẫu để lấy mã thông báo truy cập

Bước 2. Gọi API ký

POST http://localhost:8080/v2/signature/sign

API ký

Tiêu đề

Tên	Giá trị
Loại nội dung	nhiều phần/biểu mẫu-dữ liệu
X-SIGN-ACCESSTOKEN	89777718e027d33dd23f8e4f560128c6cc632336870b58fd8daed86c0727a76a

Thân thể

Tên	Giá trị
digestThuật toán	SHA256
signIdentityId	ckqtokgre4o5mrk4bajtk413ui
txId	90ca005cfb4d4827b1247889166b72fe "PK - Tệp đã ký ở định dạng .zip"

200: OK

"PK - Tệp đã ký ở định dạng .zip"

400: Yêu cầu không hợp lệ

" Yêu cầu không hợp lệ"

Chuyển mã thông báo truy cập như một phần của tiêu đề (X-SIGN-ACCESSTOKEN = Mã truy cập) cùng với danh tính ký và id giao dịch trong lệnh gọi API tiếp theo như hình dưới đây.

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

Lệnh curl mẫu

curl --location 'http://localhost:8080/v2/signature/sign'
--header 'Content-Type: multipart/form-data'
--header 'X-SIGN-ACCESSTOKEN: 89777718e027d33dd23f8e4f560128c6cc632336870b58fd8daed86c0727a76a'
--form 'digestAlgorithm="SHA256"'
--form 'signIdentityId="ckqtoskgre4o5mrk4bajtsk41r3ui"'
--form 'txId="90ca005cfb4d4827b1247889166b72fe"'

Danh sách các thuộc tính cho nội dung yêu cầu:

txId

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.

digestThuật toán

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

ID chứng chỉ đủ điều kiện của người dùng

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

Was this helpful?

Thank you!