TÀI LIỆU HƯỚNG KẾT NỐI DỮ LIỆU DÙNG CHUNG HỆ THỐNG NGSP QUỐC GIA

TÀI LIỆU HƯỚNG KẾT NỐI DỮ LIỆU DÙNG CHUNG HỆ THỐNG NGSP QUỐC GIA SDT Copyright 2020 I MỤC LỤC Thông tin kết nối: II Chi tiết API kết nối API get Token (API LGSP cung cấp) API Danh mục mã định danh kết nối hệ thống QLVBĐH cấp API Danh mục mã định danh kết nối hệ thống QLVBĐH cấp API Danh mục mã định danh kết nối hệ thống QLVBĐH cấp API Danh mục mã định danh kết nối hệ thống QLVBĐH cấp API Danh mục mã số đơn vị hành Việt Nam cấp (Tỉnh) API Danh mục mã số đơn vị hành Việt Nam cấp (Quận, Huyện) 10 API Danh mục mã số đơn vị hành Việt Nam cấp (Phường, Xã) 11 API Danh mục Mã bưu vùng, khu vực 12 10 API Danh mục Mã bưu cấp (Tỉnh) 13 11 API Danh mục Mã bưu cấp (Quận, Huyện) 14 12 API Danh mục Mã bưu cấp (Phường, Xã) 15 13 API Danh mục mã dân tộc 16 14 API Danh mục mã dân tộc tên gọi khác 17 15 API Danh mục mã tôn giáo 18 16 API Danh mục mã giới tính 19 17 API Danh mục mã nhóm máu 20 18 API Danh mục mã ý nghĩa nhóm máu 20 19 API Danh mục mã Quốc gia, quốc tịch 21 20 API Danh mục mã Tình trạng nhân 23 21 API Danh mục giáo dục, đào tạo Việt Nam Cấp 24 22 API Danh mục giáo dục, đào tạo Việt Nam Cấp 25 23 API Danh mục giáo dục, đào tạo Việt Nam Cấp 26 24 API Danh mục giáo dục, đào tạo cấp IV trình độ cao đẳng, đại học 27 25 API Danh mục giáo dục, đào tạo cấp IV trình độ thạc sĩ, tiến sĩ 28 26 API Danh mục mã chức danh quan Đảng cộng sản Việt Nam 29 SDT Copyright 2020 27 API Danh mục bậc lương 30 28 API Danh mục bảng lương 31 29 API Danh mục loại công chức, viên chức, nhân viên, lãnh đạo 32 30 API Danh mục nhóm lương 32 31 API Danh mục mã hệ số lương 33 32 API Danh mục mã mức lương tối thiểu vùng 34 33 API Danh mục mã thi đua khen thưởng 35 34 API Danh mục Mã loại văn theo quy định pháp luật 36 35 API Danh mục Mã tên loại văn quy phạm pháp luật 37 36 API Danh mục Mã tên loại văn hành 38 37 API Danh mục Mã quy định độ khẩn văn 39 SDT Copyright 2020 I Thông tin kết nối: Tên Giá trị client_id qCZBb7fwf_MAlD7mOzLpiS7RWcoa client_secret 6NJpUQfKCPIqk53AVmNa3oDmvjMa grant_type client_credentials II Chi tiết các API kết nối END_POINT_URL: https://lgsp.danang.gov.vn/dng/dmdc/1.0 API get Token (API LGSP cung cấp) - API LGSP chia sẻ để lấy giá trị token để gọi các API khác, các API khác gọi tới phải truyền theo token header - Giá trị token có thời gian timeout, vậy mỗi lần gọi các API để lấy dữ liệu sẽ gọi API get Token để lấy token Phương thức lấy Token: - Đường dẫn: https://lgsp.danang.gov.vn/token - Method: HTTP POST - Input: o Header:  Content-Type=” application/x-www-form-urlencoded” o Body: // Truyền thông tin kết nối ở - Output: { "access_token": "19683afe-d546-3ea4-83a8-4f274fe970ff", "token_type": "Bearer", "expires_in": 3600 SDT Copyright 2020 } API Danh mục mã định danh kết nối các hệ thống QLVBĐH cấp - Đường dẫn: END_POINT_URL + /qlvanbandieuhanhcap1 - Phương thức: GET - Đầu vào: o Header:  Authorization = “Bearer ” + access_token - Đầu ra: [ { "maDinhDanhCap1": "000.00.00.H30", "tenDonVi": "UBND tỉnh Hậu Giang", "diaChi": null, "email": null, "soDienThoai": null, "fax": null, "website": null, "qdBanHanhQdSuaDoi": "1220/QĐ-UBND", "ngayBanHanhQd": "16/08/2018", "coQuanBanHanhQd": "UBND tỉnh Hậu Giang" }, { "maDinhDanhCap1": "000.00.00.G13", "tenDonVi": "Bộ Tài nguyên Môi trường", "diaChi": null, "email": null, "soDienThoai": null, "fax": null, SDT Copyright 2020 "website": null, "qdBanHanhQdSuaDoi": "2180/QĐ-BTNMT", "ngayBanHanhQd": "06/07/2018", "coQuanBanHanhQd": "Bộ Tài nguyên Môi trường" }, … ] API Danh mục mã định danh kết nối các hệ thống QLVBĐH cấp - Đường dẫn: END_POINT_URL + /qlvanbandieuhanhcap2 - Phương thức: GET - Đầu vào: o Header:  Authorization = “Bearer ” + access_token - Đầu ra: [ { "maDinhDanhCap2": "000.00.44.H48", "tenDonVi": "Thanh Tra tỉnh", "diaChi": null, "email": null, "soDienThoai": null, "fax": null, "website": null, "qdBanHanhQdSuaDoi": "1037/QĐ_UBND", "ngayBanHanhQd": "27/06/2018", "coQuanBanHanhQd": "UBND tỉnh Quảng Ngãi" }, { SDT Copyright 2020 "maDinhDanhCap2": "000.00.12.H35", "tenDonVi": "Sở Nông nghiệp Phát triển Nông thôn", "diaChi": null, "email": null, "soDienThoai": null, "fax": null, "website": null, "qdBanHanhQdSuaDoi": "1530/QĐ-UBND", "ngayBanHanhQd": "24/11/2017", "coQuanBanHanhQd": "UBND tỉnh Lai Châu" }, … ] API Danh mục mã định danh kết nối các hệ thống QLVBĐH cấp - Đường dẫn: END_POINT_URL + /qlvanbandieuhanhcap3 - Phương thức: GET - Đầu vào: o Header:  Authorization = “Bearer ” + access_token - Đầu ra: [ { "maDinhDanhCap3": "000.02.31.H34", "tenDonVi": "UBND Ia Tơi", "diaChi": null, "email": null, "soDienThoai": null, "fax": null, SDT Copyright 2020 "website": null, "qdBanHanhQdSuaDoi": "78/QĐ-UBND", "ngayBanHanhQd": "22/01/2018", "coQuanBanHanhQd": "UBND tỉnh Kon Tum" }, { "maDinhDanhCap3": "000.16.23.H24", "tenDonVi": "Văn phòng HĐND - UBND", "diaChi": null, "email": null, "soDienThoai": null, "fax": null, "website": null, "qdBanHanhQdSuaDoi": "2140/QĐ-UBND", "ngayBanHanhQd": "03/10/2016", "coQuanBanHanhQd": "UBND thành phớ Hải Phịng" }, … ] API Danh mục mã định danh kết nối các hệ thống QLVBĐH cấp - Đường dẫn: END_POINT_URL + qlvanbandieuhanhcap4 - Phương thức: GET - Đầu vào: o Header:  Authorization = “Bearer ” + access_token - Đầu ra: [ { SDT Copyright 2020 "maDinhDanhCap4": "014.03.26.H07", "tenDonVi": "Trường Trung học sở Thành Thới A", "diaChi": null, "email": null, "soDienThoai": null, "fax": null, "website": null, "qdBanHanhQdSuaDoi": "379/QĐ-UBND", "ngayBanHanhQd": "02/08/2017", "coQuanBanHanhQd": "UBND tỉnh Bến Tre" }, { "maDinhDanhCap4": "038.02.35.H50", "tenDonVi": "Trường THCS thị trấn Krông Klang", "diaChi": null, "email": null, "soDienThoai": null, "fax": null, "website": null, "qdBanHanhQdSuaDoi": "1258/QĐ UBND", "ngayBanHanhQd": "23/06/2018", "coQuanBanHanhQd": "UBND tỉnh Quảng Trị" }, … ] API Danh mục mã số các đơn vị hành Việt Nam cấp (Tỉnh) - Đường dẫn: END_POINT_URL + /donvihanhchinhcap1 - Phương thức: GET SDT Copyright 2020 - Đầu vào: o Header:  Authorization = “Bearer ” + access_token - Đầu ra: [ { "maSoCapTinh": "68", "tenDonViHanhChinh": "Tỉnh Lâm Đồng" }, { "maSoCapTinh": "08", "tenDonViHanhChinh": "Tỉnh Tuyên Quang" }, … ] API Danh mục mã số các đơn vị hành Việt Nam cấp (Quận, Huyện) - Đường dẫn: END_POINT_URL + /donvihanhchinhcap2 - Phương thức: GET - Đầu vào: o Header:  Authorization = “Bearer ” + access_token - Đầu ra: [ { "maSoCapTinh": "48", "maSoCapQuanHuyenThiXa": "490", "tenDonViHanhChinh": "Quận Liên Chiểu" }, SDT Copyright 2020