Dịch vụ cung cấp

  1. Giới thiệu Danh mục dùng chung
  • Tài liệu này dung cho các cán bộ kỹ thuật lập trình nhằm phát triển tích hợp ứng dụng của mình với các dịch vụ danh mục thuộc phần mềm danh mục điện tử dùng chung của các cơ qua nhà nước phục vụ phát triển Chính phủ điện tử.
  1. Mô hình kết nối

  • Trình tự kết nối:
  • Bước 1: yêu cầu access token. Hệ thống thông tin (HTTT) cấp Bộ / Tỉnh / Thành phố sử dụng cặp khóa (consumer_key và secret_key) do LGSP cung cấp, gửi yêu cầu lấy token để truy cập các dịch vụ do LGSP cung cấp.
  • Bước 2: xác thực và tạo token. LGSP tiến hành xác thực các cặp khóa và khởi tạo token cho phép HTTT truy cập các dịch vụ được cấp phép.
  • Bước 3: trả về token. Sau khi khởi tạo token, LGSP tiến hành đóng gói và trả token cho HTTT. Token này chỉ có giá trị sử dụng trong một phiên làm việc với một khoảng thời gian timeout nhất định do NGSP quy định.
  • Bước 4: đóng gói yêu cầu khai thác dịch vụ với token. Yêu cầu khai thác dịch vụ được gửi tới LGSP cần có 2 thành phần: (1) Thông tin đầu vào như: đơn hàng, mã đơn hàng, số lượng, v.v…; (2) Thông tin token.
  • Bước 5: gửi yêu cầu khai thác dịch vụ. Các HTTT của Bộ/Tỉnh gửi yêu cầu gián tiếp khai thác Adapter thông qua trung gian kết nối LGSP của Bộ/Tỉnh tới NGSP.
  • Bước 6: xác thực token và kiểm tra quyền truy cập. LGSP tiến hành kiểm tra tính hợp lệ của token với dịch vụ được yêu cầu. Nếu HTTT chưa đăng ký sử dụng dịch vụ đang được yêu cầu, LGSP sẽ chặn quyền truy cập dịch vụ. Ngược lại, nếu HTTT đã đăng ký sử dụng dịch vụ, NGSP tiếp tục thực hiện các bước tiếp theo.
  • Bước 7: tổng hợp dữ liệu. LGSP tiến hành thực hiện các công việc cần thiết để tổng hợp dữ liệu tương ứng với từng dịch vụ được yêu cầu.
  • Bước 8: trả về dữ liệu. HTTT cấp Bộ/Tỉnh kết nối qua trung gian LGSP dữ liệu sẽ được NGSP trả về ngay khi NGSP tổng hợp cho LGSP việc chuyển tiếp dữ liệu tới các HTTT sẽ do các Bộ/Tỉnh chủ động phương án.
  1.  Danh sách dịch vụ
  • API lấy thông tin token

  • API lấy danh sách danh mục

  • API danh mục - mã định danh kết nối các hệ thống QLVBĐH cấp 1

  • Lấy cấu trúc danh mục

  • Lấy dữ liệu

  • Bổ sung dữ liệu danh mục

  • API danh mục - mã định danh kết nối các hệ thống QLVBĐH cấp 2

  • Lấy cấu trúc danh mục

  • Lấy dữ liệu

  • Bổ sung dữ liệu danh mục