Đối tượng sử dụng:
Nhân viên kỹ thuật của các Nhà phát triển bên ngoài MISA.
Tóm tắt nội dung tài liệu:
Tài liệu này hướng dẫn chi tiết về tích hợp API cho dịch vụ chữ ký số từ xa MISA eSign, bao gồm tổng quan về luồng kết nối, phương thức xác thực, cấu trúc API và quy trình ký số hoàn chỉnh. Nội dung trình bày các khái niệm, định nghĩa API, mô tả dữ liệu, mã lỗi thường gặp và các bước thao tác chuẩn.
API hỗ trợ đầy đủ các bước trong một luồng ký số từ xa: xác thực người dùng và lấy token, lấy thông tin chứng thư số (CTS), tạo hash cho tài liệu (PDF, Word, Excel, XML), gửi yêu cầu ký và xác thực qua ứng dụng MISA eSign, kiểm tra trạng thái ký và gắn chữ ký số hoàn thiện vào tài liệu gốc. Mỗi hạng mục đều đi kèm hướng dẫn về endpoint, tham số, dữ liệu đầu ra và cách xử lý kết quả, hỗ trợ lập trình viên nhanh chóng tích hợp giải pháp ký số từ xa của MISA vào các hệ thống khác.
Ngày phát cập nhật tài liệu lần cuối: 15/09/2025
Người phát hành tài liệu: Phòng Tích hợp hệ thống – Công ty Cổ phần MISA
Nội dung chi tiết tài liệu Open API: Tại đây
Đặt mua Chữ ký số MISA: Tại đây
Các bước tiến hành tích hợp:
- Nghiên cứu Tài liệu: Đọc kỹ tài liệu API mở để nắm vững các luồng nghiệp vụ và yêu cầu kỹ thuật.
- Đăng ký sử dụng API: Liên hệ với MISA để đăng ký, nhận
clientId,clientKeyvà tài khoản thử nghiệm. - Xác thực: Thực hiện luồng đăng nhập, xác thực hai lớp (nếu có) để lấy
access tokencho các phiên làm việc. - Tích hợp Luồng ký: Xây dựng các bước gọi API theo đúng quy trình: Lấy thông tin CTS -> Hash tài liệu -> Gửi yêu cầu ký -> Kiểm tra trạng thái -> Gắn chữ ký vào tài liệu gốc.
- Nghiệm thu: Kiểm tra và xác thực các tài liệu đã được ký thành công.
Nếu bạn đến từ Nhà phát triển phần mềm thương mại, muốn trở thành Đối tác tích hợp chính thức của MISA (miễn phí & có nhóm hỗ trợ riêng) thì đăng ký: Tại đây.
