TÀI LIỆU HƯỚNG KẾT NỐI DỮ LIỆU DÙNG CHUNG LGSP ĐÀ NẴNG SDT Copyright 2020 MỤC LỤC I 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 sách quan API Lấy quan theo mã API danh sách công chức API Lấy công chức theo mã API danh sách chức vụ API Lấy chức vụ theo mã 10 API danh sách học vấn 11 API Lấy học vấn theo mã 12 10 API danh sách thủ tục hành 13 11 API Lấy thủ tục hành theo mã 14 12 API danh sách nhóm thủ tục hành 16 13 API Lấy nhóm thủ tục hành theo mã 17 14 API danh sách cấp quan quản lý 17 15 API Lấy cấp quan quản lý theo mã 18 16 API danh sách đơn vị hành 19 17 API Lấy đơn vị hành theo mã 20 18 API danh sách chuyên môn 21 19 API Lấy chuyên môn theo mã 22 20 API danh sách giấy tờ 23 21 API Lấy giấy tờ theo mã 23 22 API danh sách cấp đơn vị hành 24 23 API Lấy cấp đơn vị hành theo mã 25 24 API danh sách danh mục ứng dụng 26 25 API Lấy danh mục ứng dụng theo mã 27 26 API danh sách danh mục dân tộc 28 SDT Copyright 2020 27 API Lấy dân tộc theo mã 29 28 API danh sách giới tính 30 29 API Lấy giới tính theo mã 30 30 API danh sách loại doanh nghiệp 31 31 API Lấy loại doanh nghiệp theo mã 32 32 API danh sách loại đối tượng 33 33 API Lấy loại đối tượng theo mã 34 34 API danh sách ngành nghề 34 35 API Lấy ngành nghề theo mã 36 36 API danh sách nghề nghiệp 36 37 API Lấy nghề nghiệp theo mã 37 38 API danh sách ngoại tệ 38 39 API Lấy ngoại tệ theo mã 39 40 API danh sách quan hệ gia đình 40 41 API Lấy quan hệ gia đình theo id 41 42 API danh sách quốc gia 41 43 API Lấy quốc gia theo mã 42 44 API danh sách tình trạng nhân 43 45 API Lấy tình trạng nhân theo id 44 46 API danh sách tôn giáo 44 47 API Lấy tôn giáo theo mã 45 48 API trạng thái doanh nghiệp 46 49 API Lấy trạng thái doanh nghiệp theo id 47 50 API danh sách trạng thái hồ sơ 48 51 API Lấy trạng thái hồ sơ theo id 48 52 API danh sách trình độ chun mơn 49 53 API Lấy trình độ chuyên môn theo mã 50 SDT Copyright 2020 I Thông tin kết nối: Tên Giá trị client_id 6aSoqSHvNPFhTOb_gl8b0nSl1iAa client_secret TlJ7bVslKKIEX8G0yGP42kfgLDca grant_type client_credentials II Chi tiết các API kết nối END_POINT_URL: https://lgsp.danang.gov.vn/dldc/1.0.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 sách quan - Đường dẫn: END_POINT_URL + /coquan - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token - Đầu ra: { "objects": { "object": [ { "capCQQL": "UBND Tỉnh, TP", "ma": "00048", "chaId": "", "capCoQuanId": "2", "id": "1", "ten": "UBND thành phố Đà Nẵng" }, { "capCQQL": "UBND quận, huyện", "ma": "00490", "chaId": "1", "capCoQuanId": "3", "id": "2", "ten": "UBND quận Liên Chiểu" }, SDT Copyright 2020 … ] } } API Lấy quan theo mã - Đường dẫn: END_POINT_URL + /coquan/ma/{ma} - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token o Path param: ma (Mã quan) - Đầu ra: { "objects": { "object": [ { "capCQQL": "UBND quận, huyện", "ma": "00490", "chaId": "1", "capCoQuanId": "3", "id": "2", "ten": "UBND quận Liên Chiểu" } ] } } SDT Copyright 2020 API danh sách công chức - Đường dẫn: END_POINT_URL + /congchuc - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token - Đầu ra: { "objects": { "object": [ { "dienThoai": "", "soCMND": "", "coQuanId": "46", "chucVu": "Chuyên viên xử lý", "noiCapCMND": "", "coQuan": "UBND quận Cẩm Lệ", "hoVaTen": "Trường Mầm Non Bình Minh", "chucVuId": "9", "ma": "7887", "ngaySinh": "15/04/2020", "id": "1", "email": "mnbinhminhcl@danang.gov.vn", "ngayCapCMND": "" }, { "dienThoai": "", SDT Copyright 2020 "soCMND": "", "coQuanId": "2", "chucVu": "Chuyên viên xử lý", "noiCapCMND": "", "coQuan": "UBND quận Liên Chiểu", "hoVaTen": "Huỳnh Thị Kim Anh", "chucVuId": "9", "ma": "14255", "ngaySinh": "15/04/2020", "id": "2", "email": "tanhhtk2@danang.gov.vn", "ngayCapCMND": "" }, … ] } } API Lấy công chức theo mã - Đường dẫn: END_POINT_URL + /congchuc/ma/{ma} - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token o Path param: ma (Mã công chức) - Đầu ra: { SDT Copyright 2020 "objects": { "object": [ { "dienThoai": "", "soCMND": "", "coQuanId": "2", "chucVu": "Chuyên viên xử lý", "noiCapCMND": "", "coQuan": "UBND quận Liên Chiểu", "hoVaTen": "Huỳnh Thị Kim Anh", "chucVuId": "9", "ma": "14255", "ngaySinh": "15/04/2020", "id": "2", "email": "anhhtk2@danang.gov.vn", "ngayCapCMND": "" } ] } } API danh sách chức vụ - Đường dẫn: END_POINT_URL + /chucvu - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token - Đầu ra: SDT Copyright 2020 { "objects": { "object": [ { "ma": "001", "id": "1", "ten": "Cán tiếp nhận cửa" }, { "ma": "017", "id": "2", "ten": "Chủ tịch" }, … ] } } API Lấy chức vụ theo mã - Đường dẫn: END_POINT_URL + /chucvu/ma/{ma} - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token o Path param: ma (Mã chức vụ) - Đầu ra: { "objects": { SDT Copyright 2020 Accept = “application/json” Authorization = “Bearer ” + access_token - Đầu ra: { "objects": { "object": [ { "ma": "1", "id": "1", "ten": "Lãnh đạo (lãnh đạo có quyền lực cao, huy điều hành) thuộc các lĩnh vực các ngành, các cấp" }, { "ma": "2", "id": "2", "ten": "Chuyên môn kỹ thuật bậc cao các lĩnh vực" }, … ] } } 37 API Lấy nghề nghiệp theo mã - Đường dẫn: END_POINT_URL + /nghenghiep/ma/{ma} - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token SDT Copyright 2020 o Path param: ma (Mã nghề nghiệp) - Đầu ra: { "objects": { "object": [ { "ma": "2", "id": "2", "ten": "Chuyên môn kỹ thuật bậc cao các lĩnh vực" } ] } } } 38 API danh sách ngoại tệ - Đường dẫn: END_POINT_URL + /ngoaite - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token - Đầu ra: { "objects": { "object": [ { "tyGia": "1.00", SDT Copyright 2020 "ma": "VND", "id": "2", "ten": "Việt nam đồng" }, { "tyGia": "21000.00", "ma": "USD", "id": "3", "ten": "Ðô la Mỹ" }, … ] } } 39 API Lấy ngoại tệ theo mã - Đường dẫn: END_POINT_URL + /ngoaite/ma/{ma} - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token o Path param: ma (Mã nghề nghiệp) - Đầu ra: { "objects": { "object": [ { "tyGia": "1.00", SDT Copyright 2020 "ma": "VND", "id": "2", "ten": "Việt nam đồng" } ] } 40 API danh sách quan hệ gia đình - Đường dẫn: END_POINT_URL + /quanhegiadinh - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token - Đầu ra: { "objects": { "object": [ { "id": "1", "ten": "Cha" }, { "id": "2", "ten": "Mẹ" }, … ] } SDT Copyright 2020 } 41 API Lấy quan hệ gia đình theo id - Đường dẫn: END_POINT_URL + /quanhegiadinh/{id} - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token o Path param: id (Quan hệ gia đình) - Đầu ra: { "objects": { "object": [ { "id": "10", "ten": "Bà nội" } ] } } 42 API danh sách quốc gia - Đường dẫn: END_POINT_URL + /quocgia - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token SDT Copyright 2020 - Đầu ra: { "objects": { "object": [ { "ma": "VIE", "id": "1", "ten": "Việt Nam" }, { "ma": "AX", "id": "2", "ten": "And Islands" }, … ] } } 43 API Lấy quốc gia theo mã - Đường dẫn: END_POINT_URL + /quocgia/ma/{ma} - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token o Path param: ma (Mã quốc gia) - Đầu ra: SDT Copyright 2020 { "objects": { "object": [ { "ma": "AX", "id": "2", "ten": "And Islands" } ] } } 44 API danh sách tình trạng nhân - Đường dẫn: END_POINT_URL + /tinhtranghonnhan - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token - Đầu ra: { "objects": { "object": [ { "id": "1", "ten": "Độc thân" }, { "id": "2", SDT Copyright 2020 "ten": "Đã kết hôn" }, … ] } } 45 API Lấy tình trạng nhân theo id - Đường dẫn: END_POINT_URL + /tinhtranghonnhan/{id} - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token o Path param: id (Id tình trạng nhân) - Đầu ra: { "objects": { "object": [ { "id": "3", "ten": "Ly dị" } ] } } 46 API danh sách tôn giáo - Đường dẫn: END_POINT_URL + /tongiao SDT Copyright 2020 - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token - Đầu ra: { "objects": { "object": [ { "ma": "01", "id": "1", "ten": "Phật Giáo" }, { "ma": "02", "id": "2", "ten": "Công giáo" }, … ] } } 47 API Lấy tôn giáo theo mã - Đường dẫn: END_POINT_URL + /tongiao/ma/{ma} - Phương thức: GET - Đầu vào: o Header: SDT Copyright 2020 Accept = “application/json” Authorization = “Bearer ” + access_token o Path param: ma (Mã tôn giáo) - Đầu ra: { "objects": { "object": [ { "ma": "01", "id": "1", "ten": "Phật Giáo" } ] } } 48 API trạng thái doanh nghiệp - Đường dẫn: END_POINT_URL + /tinhtranghonnhan - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token - Đầu ra: { "objects": { "object": [ { SDT Copyright 2020 "id": "1", "ten": "Cấp mới" }, { "id": "2", "ten": "Tạm ngưng hoạt động" }, … ] } } 49 API Lấy trạng thái doanh nghiệp theo id - Đường dẫn: END_POINT_URL + /trangthaidoanhnghiep/{id} - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token o Path param: id (Id trạng thái doanh nghiệp) - Đầu ra: { "objects": { "object": [ { "id": "1", "ten": "Cấp mới" } SDT Copyright 2020 ] } } 50 API danh sách trạng thái hồ sơ - Đường dẫn: END_POINT_URL + /trangthaihoso - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token - Đầu ra: { "objects": { "object": [ { "id": "1", "ten": "Hồ sơ chủn phịng chun mơn" }, { "id": "2", "ten": "Chờ xử lý" }, … ] } } 51 API Lấy trạng thái hồ sơ theo id - Đường dẫn: END_POINT_URL + /trangthaihoso/{id} SDT Copyright 2020 - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token o Path param: id (Id trạng thái hồ sơ) - Đầu ra: { "objects": { "object": [ { "id": "19", "ten": "Hồ sơ mới tiếp nhận" } ] } } 52 API danh sách trình độ chun mơn - Đường dẫn: END_POINT_URL + /trinhdochuyenmon - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token - Đầu ra: { "objects": { SDT Copyright 2020 "object": [ { "chuyenMonId": "1", "ma": "0001", "loai": "1", "id": "1", "ten": "Bác sỹ" }, { "chuyenMonId": "42", "ma": "0002", "loai": "1", "id": "2", "ten": "Y sỹ" }, … ] } } 53 API Lấy trình độ chun mơn theo mã - Đường dẫn: END_POINT_URL + /trinhdochuyenmon/ma/{ma} - Phương thức: GET - Đầu vào: o Header: Accept = “application/json” Authorization = “Bearer ” + access_token o Path param: ma (Mã trình độ chun mơn) SDT Copyright 2020 - Đầu ra: { "objects": { "object": [ { "chuyenMonId": "81", "ma": "0008", "loai": "2", "id": "8", "ten": "Dược sỹ cao đẳng" } ] } } SDT Copyright 2020