Trung tâm nhà phát triển

Hướng dẫn tích hợp

1. Hướng dẫn tích hợp

1.1 Quy trình tích hợp

Quy trình tích hợp được hiển thị trong hình dưới đây.

集成流程.svg

1.1.1 Đăng ký tài khoản eSignGlobal

Nhà phát triển cần truy cập trang web chính thức của eSignGlobal để đăng ký tài khoản.

Địa chỉ kết nối OpenAPI:

1.1.2 Tạo ứng dụng

Đăng nhập vào eSignGlobal, quản trị viên có thể thêm ứng dụng trong menu Cài đặt - Tích hợp - Ứng dụng và lấy khóa trong trang chỉnh sửa ứng dụng, đồng thời định cấu hình địa chỉ gọi lại.

1.1.3 Xác định quy trình nghiệp vụ

Sau khi đọc xong tài liệu này, nhà phát triển sắp xếp các quy trình nghiệp vụ hiện có và kết nối các giao diện tương ứng tại nút ký kết nghiệp vụ để triển khai khả năng chữ ký điện tử trên quy trình nghiệp vụ hiện có.

1.1.4 Tích hợp giao diện

Trong bước này, chính thức bắt đầu công việc kết nối. Nếu bạn gặp vấn đề trong quá trình kết nối, bạn có thể liên hệ với nhóm eSignGlobal để được hỗ trợ giải quyết.

1.1.5 Kiểm tra nghiệp vụ

Sau khi hoàn thành kết nối chức năng giao diện, hãy thực hiện một vài vòng kiểm tra quy trình nghiệp vụ nếu cần. Nếu bạn gặp vấn đề trong quá trình kiểm tra, bạn có thể liên hệ với nhóm eSignGlobal để được hỗ trợ giải quyết.

1.1.6 Phát hành dự án

Nhà phát triển có thể phát hành dự án sau khi hoàn thành các thao tác sau:

  • Chuyển đổi môi trường truy cập giao diện:Môi trường sandbox ➡ Môi trường chính thức
  • Chuyển đổi thông tin ứng dụng:sandbox app_id, app_secret ➡ app_id, app_secret chính thức

2. Ví dụ quy trình

Dưới đây là quy trình gọi giao diện của một số tình huống ứng dụng điển hình, phương thức gọi cụ thể tùy thuộc vào thiết kế nghiệp vụ của bạn.

Nội dung số trong hình là quy trình thao tác nghiệp vụ chữ ký điện tử tiêu chuẩn, khung màu xám là dịch vụ API do eSginGlobal cung cấp.

2.1 Quy trình gọi API (tình huống cổ điển) —— Khởi tạo theo từng bước

分步发起流程.svg

2.2 Quy trình gọi API (tình huống cổ điển) —— Khởi tạo nhanh

一步发起.svg

3. Tóm tắt

Quy trình nghiệp vụ chữ ký điện tử được chia thành ba giai đoạn: khởi tạo, tạo và mở phong bì, ký.

Các nút quy trình quan trọng được mô tả như sau:

  1. Trích xuất thông tin quan trọng để ký:Khi khởi tạo chữ ký điện tử thông qua eSignGlobal, nền tảng kết nối chỉ cần cung cấp thông tin người ký, tài liệu cần ký, v.v. để khởi tạo hợp đồng ký. Thông tin này thường được thu thập và lưu trữ trong hệ thống nghiệp vụ trong quá trình nghiệp vụ trước đó.
  2. Tạo phong bì:eSignGlobal hướng đến việc xây dựng dịch vụ chữ ký điện tử toàn cầu đáng tin cậy, do đó, các hành vi ký đối với tài liệu cần ký (còn gọi là nhiệm vụ ký) đều được biểu thị thông qua phong bì. Khi tạo quy trình ký, nền tảng kết nối có thể tùy chỉnh cấu hình các chức năng liên quan, chẳng hạn như chủ đề, ghi chú, v.v.
  3. Tạo tài liệu cần ký:Hiện tại, eSignGlobal chỉ hỗ trợ tài liệu cần ký ở định dạng PDF. Nền tảng kết nối cần chuẩn bị trước tài liệu ký và thêm vào quy trình ký thông qua "các API liên quan đến tải lên tệp".
  4. Thêm người ký:Trong bước này, nền tảng kết nối có thể thêm các bên ký vào phong bì, đồng thời có thể định cấu hình trải nghiệm người dùng của người ký, chẳng hạn như thứ tự ký, vị trí ký, có cần mật khẩu truy cập hay không, v.v.
  5. Mở phong bì:Tức là cho phép người ký bắt đầu ký tài liệu. Sau khi phong bì được mở, không hỗ trợ thêm và sửa đổi tài liệu cần ký, đồng thời sẽ tự động bắt đầu luân chuyển theo thứ tự ký đã đặt trước và eSignGlobal sẽ gửi thông báo ký.
  6. Kết thúc phong bì:Tức là sau khi tất cả những người ký hoàn thành việc ký, nền tảng kết nối sẽ đóng phong bì theo cách thủ công. (eSignGlobal sẽ hỗ trợ thêm người ký trước khi quy trình đóng lại trong tương lai.)
  7. Tải xuống tài liệu đã ký:Tức là tải xuống các tài liệu sau khi tất cả những người ký đã hoàn thành việc ký, chỉ có thể gọi sau khi phong bì kết thúc.

1. Hướng dẫn tích hợp
1.1 Quy trình tích hợp
1.1.1 Đăng ký tài khoản eSignGlobal
1.1.2 Tạo ứng dụng
1.1.3 Xác định quy trình nghiệp vụ
1.1.4 Tích hợp giao diện
1.1.5 Kiểm tra nghiệp vụ
1.1.6 Phát hành dự án
2. Ví dụ quy trình
2.1 Quy trình gọi API (tình huống cổ điển) —— Khởi tạo theo từng bước
2.2 Quy trình gọi API (tình huống cổ điển) —— Khởi tạo nhanh
3. Tóm tắt