Morpheus Mobile Client와 Gateway Server 간의 API 연동을 위한 제반 사항을 기술합니다.
요청 방식: HTTP Query String (또는 Body)
| 구분 | 항목 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| body | body | Array | Y | HTTP Method에 따라 정의되는 body 값 (예: { "body": { "deploy": "0" } }) |
API 응답은 아래와 같은 JSON 형식을 따릅니다.
공통구조
| 구분 | 항목 | Type | 필수여부 | 설명 |
|---|---|---|---|---|
| head | result_code | String | Y | 응답 결과 코드 |
| result_msg | String | Y | 응답 결과 메시지 | |
| body | 사용자 정의 | Array | Y | 응답 데이터. 값이 없으면 공란 처리 |
예시
{
"head": {
"result_code": "200",
"result_msg": "OK"
},
"body": {
"name": "홍길동"
}
}
| 코드구분 | 구분명 | 코드 | 설명 |
|---|---|---|---|
| 2xx | Successful | 200 | 정상적으로 처리 되었습니다. |
| 204 | 클라이언트 요구를 처리했으나 전송할 데이터가 없습니다. | ||
| 4xx | Client Error | 400 | 클라이언트의 잘못된 요청으로 처리할 수 없습니다. |
| 401 | 클라이이언트 인증에 실패 하였습니다. | ||
| 405 | 리소스를 허용할 수 없습니다. | ||
| 5xx | Server Error | 500 | 서버에서 오류가 발생 하였습니다. |
| 502 | 서버가 과부하 상태 입니다. | ||
| 503 | 서버가 일시적으로 다운 되었습니다. | ||
| 504 | 장시간 미사용으로 서버접속이 종료 되었습니다. | ||
| 599 | 보안 프로그램 오류 입니다. | ||
| 598 | 보안 통신이 원활하지 않습니다. | ||
| 597 | 응답결과 데이터가 존재하지 않습니다. | ||
| 596 | 응답 데이터 형식 오류가 발생하였습니다. |
| 구분 | API URL | 설명 |
|---|---|---|
| 리소스 업데이트 | /api/res/auto-update | 리소스 파일 버전을 확인하여 최신 리소스 파일 정보 조회 |
| 앱 위변조 | /getPreventToken | 앱 위변조 확인을 위해 토큰값 획득 |
| /checkAppVerify | 앱 위변조를 체크하기 위해 앱 정보(hash값 포함) 획득 | |
| APP 목록 조회 | /api/appinfo/list | AppStore에 등록된 APP 목록 정보 조회 |
| APP 정보 조회 | /api/appinfo/get | AppStore에 등록된 APP 상세 정보 조회 |
| 카테고리 목록 조회 | /api/category/list | 해당 상위코드 아래 카테고리 목록 조회 |
| APP 다운로드 이력 저장 | /api/download/add | APP 다운로드 후 다운로드 이력 저장 |
| 로그인 | /api/login/get | APP에서 사용자 로그인 처리 |
| 단말기 목록 조회 | /api/device/get | 사용자의 단말기 목록 조회 |
| 단말기 사용 중지 | /api/device/disable | 사용자의 단말기를 사용 중지처리 |
| 공지사항 조회 | /api/notice/get | 스토어 공지사항 조회 |
리소스 파일 버전을 확인하여 최신 리소스 파일 정보를 조회한다.
Method: POST
URL: http://{host}:{port}/{context}/api/res/auto-update
Headers:
Request Body
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | screen_id | String | M | 화면 스크린아이디 |
| system_name | String | M | 시스템명 | |
| phone_no | String | M | 핸드폰번호 | |
| app_version | String | M | 앱버전 | |
| appid | String | M | 앱아이디 | |
| device_md | String | M | 단말기 모델 | |
| device_id | String | M | 단말기 아이디 | |
| app_name | String | M | 앱이름 | |
| callback_request_data_flag | String | M | HTTP 요청 데이터를 응답 데이터에 포함시켜 수신할지에 대한 여부 | |
| system_version | String | M | 단말 OS 버전 | |
| user_id | String | M | 사용자 아이디 | |
| user_name | String | M | 사용자명 | |
| body | deploy | String | M | 배포유형(0:개발, 1:운영) |
| version | String | M | 배포버전 | |
| rsp | String | M | 라이선스 정보 | |
| userInfo | String | M | 사전 배포 대상 정보: 사전 배포 건에 대하여 배포 공개일 이전에 리소스 다운로드 가능한 대상 정보 |
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 | ||
|---|---|---|---|---|---|---|
| head | result_code | String | M | 처리 응답 결과 코드 | ||
| result_msg | String | M | 처리 응답 결과 메시지 | |||
| body | update_files | Array | M | |||
| role_id | String | M | 업무아이디 | |||
| role_name | String | M | 업무이름 | |||
| files | Array | M | ||||
| url | String | M | 파일 URL | |||
| md5 | String | M | 다운로드 배포 파일의 MD5 문자열 | |||
| total_file_size | String | M | 버전별 배포 파일의 전체 크기 | |||
| remove_files | Array | M | 삭제된 리소스 파일명 예: www/html/sample.html(res 폴더 하위 폴더부터 시작) | |||
| version | String | M | 배포유형(0:개발, 1:운영) | |||
| app_version_info | Array | M | ||||
| download_market_url | String | M | 앱 다운로드 주소 | |||
| required_app_version | String | M | 필수 앱 버전 | |||
| current_app_version | String | M | 현재 앱 버전 | |||
| notice | Array | M | ||||
| title | String | M | 공지사항 제목 | |||
| contents | String | M | 공지사항 내용 | |||
{
"head": {
"screen_id": "0",
"system_name": "Android",
"phone_no": "1234567890",
"app_version": "0",
"appid": "kr.co.morpheus.mobile1",
"device_md": "SM-N900S",
"device_id": "111111223333338",
"app_name": "Morpheus",
"callback_request_data_flag": "n",
"system_version": "19",
"user_id": "user",
"user_name": "name"
},
},
"body": {
"version": "0001",
"deploy": "0",
"rsp": "2cda34717dabbd2c14159a7b7ecdedf098b6d9f12139ebfa45563ea93e2ac476f120668499a994bbbcef533d34b0d495",
"userInfo": "USER01"
}
}
{
"head": {
"result_code": "",
"result_msg": ""
},
"body": {
"update_files": [
{
"role_id": "",
"role_nm": "",
"files": [{"url": "","md5": ""}],
"total_file_size": "",
"remove_files": [],
"version": ""
},
{
"role_id": "",
"role_nm": "",
"files": [{"url": "","md5": ""}],
"total_file_size": "",
"remove_files": [],
"version": ""
},
{
"role_id": "",
"role_nm": "",
"files": [{"url": "","md5": ""}],
"total_file_size": "",
"remove_files": [],
"version": ""
}
],
"app_version_info": {
"download_market_url": "",
"required_app_verion": "",
"current_app_version": ""
},
"notice": {
"title": "",
"contents": ""
}
}
}
앱 위변조 확인을 위해 토큰값 획득
Request Body
Method: POST
URL: http://{host}:{port}/{context}/api/res/getPreventToken
Headers:
Request Body
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | screen_id | String | O | 화면 스크린아이디 |
| system_name | String | O | 시스템명 | |
| phone_no | String | O | 핸드폰번호 | |
| app_version | String | O | 앱버전 | |
| appid | String | O | 앱아이디 | |
| device_md | String | O | 단말기 모델 | |
| device_id | String | O | 단말기 아이디 | |
| app_name | String | O | 앱이름 | |
| callback_request_data_flag | String | O | HTTP 요청 데이터를 응답 데이터에 포함시켜 수신할지에 대한 여부 | |
| system_version | String | O | 단말 OS 버전 | |
| user_id | String | O | 사용자 아이디 | |
| user_name | String | O | 사용자명 | |
| body | Array | M |
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | result_code | String | M | 처리 응답 결과 코드 |
| result_msg | String | M | 처리 응답 결과 메시지 | |
| screen_id | String | O | 화면 스크린아이디 | |
| system_name | String | O | 시스템명 | |
| phone_no | String | O | 핸드폰번호 | |
| app_version | String | O | 앱버전 | |
| appid | String | O | 앱아이디 | |
| device_md | String | O | 단말기 모델 | |
| device_id | String | O | 단말기 아이디 | |
| app_name | String | O | 앱이름 | |
| callback_request_data_flag | String | O | HTTP 요청 데이터를 응답 데이터에 포함시켜 수신할지에 대한 여부 | |
| system_version | String | O | 단말 OS 버전 | |
| user_id | String | O | 사용자 아이디 | |
| user_name | String | O | 사용자명 | |
| body | token | String | M | 토큰키 |
{
"head": {
"screen_id": "0",
"system_name": "Android",
"phone_no": "1234567890",
"app_version": "0",
"appid": "kr.co.morpheus.mobile1",
"device_md": "SM-N900S",
"device_id": "257630051275603",
"app_name": "Morpheus",
"callback_request_data_flag": "n",
"system_version": "19",
"user_id": "user",
"user_name": "name"
},
"body": {
}
}
{
"head": {
"result_code": "",
"result_msg": "",
"screen_id": "0",
"system_name": "Android",
"phone_no": "1234567890",
"app_version": "0",
"appid": "kr.co.morpheus.mobile1",
"device_md": "SM-N900S",
"device_id": "257630051275603",
"app_name": "Morpheus",
"callback_request_data_flag": "n",
"system_version": "19",
"user_id": "user",
"user_name": "name"
},
"body": {
"token": "55be7083538e9fb72314f15c991b458287a6c228"
}
}
앱 위변조를 체크하기 위해 앱 정보(hash값 포함) 획득
Request Body
Method: POST
URL: http://{host}:{port}/{context}/api/res/checkAppVerify
Headers:
Request Body
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | screen_id | String | M | 화면 스크린아이디 |
| system_name | String | M | 시스템명 | |
| phone_no | String | M | 핸드폰번호 | |
| app_version | String | M | 앱버전 | |
| appid | String | M | 앱아이디 | |
| device_md | String | M | 단말기 모델 | |
| device_id | String | M | 단말기 아이디 | |
| app_name | String | M | 앱이름 | |
| callback_request_data_flag | String | M | HTTP 요청 데이터를 응답 데이터에 포함시켜 수신할지에 대한 여부 | |
| system_version | String | M | 단말 OS 버전 | |
| user_id | String | M | 사용자 아이디 | |
| user_name | String | M | 사용자명 | |
| body | appID | String | M | 앱아이디 |
| appVer | String | M | 앱버전 | |
| osType | String | M | 단말 OS 타입(A:안드로이드, I:IOS) | |
| hash_key | String | M | 해시키 | |
| token | String | M | 앱위변조 토큰 |
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 | |
|---|---|---|---|---|---|
| head | result_code | String | M | 처리 응답 결과 코드 | |
| result_msg | String | M | 처리 응답 결과 메시지 | ||
| screen_id | String | M | 화면 스크린아이디 | ||
| system_name | String | M | 시스템명 | ||
| phone_no | String | M | 핸드폰번호 | ||
| app_version | String | M | 앱버전 | ||
| appid | String | M | 앱아이디 | ||
| device_md | String | M | 단말기 모델 | ||
| device_id | String | M | 단말기 아이디 | ||
| app_name | String | M | 앱이름 | ||
| callback_request_data_flag | String | M | HTTP 요청 데이터를 응답 데이터에 포함시켜 수신할지에 대한 여부 | ||
| system_version | String | M | 단말 OS 버전 | ||
| user_id | String | M | 사용자 아이디 | ||
| user_name | String | M | 사용자명 | ||
| body | resources | Array | M | ||
| hash | String | M | 해시값 | ||
| name | String | M | 파일명 | ||
| entry | String | M | 경로 포함 파일명 | ||
| mtime | long | M | 수정시간 | ||
| size | Integer | M | 파일크기 | ||
| bundles | Array | M | |||
| hash | String | M | 해시값 | ||
| name | String | M | 파일명 | ||
| entry | String | M | 경로 포함 파일명 | ||
| mtime | long | M | 수정시간 | ||
| size | Integer | M | 파일크기 | ||
| build | String | M | 앱위변조 빌드버전 | ||
{
"head": {
"screen_id": "0",
"system_name": "Android",
"phone_no": "1234567890",
"app_version": "0",
"appid": "kr.co.morpheus.mobile1",
"device_md": "SM-N900S",
"device_id": "257630051275603",
"app_name": "Morpheus",
"callback_request_data_flag": "n",
"system_version": "19",
"user_id": "user",
"user_name": "name"
},
"body": {
"appId": "com.uracle.push.demo",
"appVer": "1",
"osType": "A",
"hash_key": "9e1d6918eff367c86dd8d5e2594cc809dae8f165",
"token": "9e1d6918eff367c86dd8d5e2594cc809dae8f165"
}
}
{
"head": {
"result_code": "",
"result_msg": "",
"screen_id": "0",
"system_name": "Android",
"phone_no": "1234567890",
"app_version": "0",
"appid": "kr.co.morpheus.mobile1",
"device_md": "SM-N900S",
"device_id": "257630051275603",
"app_name": "Morpheus",
"callback_request_data_flag": "n",
"system_version": "19",
"user_id": "user",
"user_name": "name"
},
"body": {
"resources": [
{
"entry": "assets/res/Manifest.xml",
"size": 1730,
"name": "Manifest.xml",
"mtime": 1706850750000,
"hash": "79dc998959451ccf745519c839c7dc8b"
},
{
"entry": "assets/res/mcore.mobile.lic",
"size": 2281,
"name": "mcore.mobile.lic",
"mtime": 1706850750000,
"hash": "50420cca204ee4a6695acd4615931f62"
}
],
"bundles": [
{
"entry": "META-INF/com/android/build/gradle/app-metadata.properties",
"size": 56,
"name": "app-metadata.properties",
"mtime": 1706850750000,
"hash": "940c8a9678279ada3922fad99a606546"
},
{
"entry": "META-INF/INDEX.LIST",
"size": 273,
"name": "INDEX.LIST",
"mtime": 1706850750000,
"hash": "c0778d17aa2d182a910d47aa0e97e21b"
},
{
"entry": "META-INF/androidx.activity_activity.version",
"size": 6,
"name": "androidx.activity_activity.version",
"mtime": 1706850750000,
"hash": "730852c545ad888d07333a229acd5ed0"
}
],
"build": "1.0.0"
}
}
AppStore에 등록된 APP 목록을 조회한다
Method: POST
URL: http://{host}:{port}/{context}/api/appinfo/auto-list
Headers:
Request Body
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | Array | M | ||
| body | userid | String | M | |
| system_name | String | M | 시스템명 | |
| app_no | String | M | 앱일련번호 |
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 | |
|---|---|---|---|---|---|
| head | result_code | String | M | 처리 응답 결과 코드 | |
| result_msg | String | M | 처리 응답 결과 메시지 | ||
| body | list | Array | M | ||
| ResultCd | String | M | 결과 코드 | ||
| ResultMsg | String | M | 결과 메시지 | ||
| app_no | String | M | 앱일련번호 | ||
| app_id | String | M | 앱아이디 | ||
| app_nm | String | M | 앱이름 | ||
| package_nm | String | M | 패키지명 | ||
| required | String | M | 필수여부(10. 필수, 20.일반) | ||
| cate_cd | String | M | 카테고리코드 | ||
| cate_nm | String | M | 카테고리명 | ||
| icon_app_url | String | M | 작은아이콘URL(등록된 아이콘이 없으면 default 제공) | ||
| icon_app_bic_url | String | M | 큰아이콘URL(등록된 아이콘이 없으면 default 제공) | ||
| app_ver | String | M | 앱버전 | ||
| bin_url | String | M | 앱설치파일경로 | ||
| bin_size | Integer | M | 앱설치파일크기 | ||
| reg_dttm | String | M | 등록일 | ||
| dl_cnt | Integer | M | 다운로드 횟수 | ||
| install_type | String | M | 설치타입 (F:파일, A:앱스토어, B:브라우저) | ||
| install_data | String | M | 설치정보 | ||
{
"head": {
},
"body": {
"userid": "test01",
"system_name": "iOS",
"app_no": "1"
}
}
{
"head": {
"result_code": "200",
"result_msg": "Success"
},
"body": {
"ResultCd": 0,
"ResultMsg": "리스트 조회 완료",
"list": [
{
"app_no": "1",
"app_id": "1",
"app_nm": "PUSH_TEST",
"package_nm": "com.uracle.push.test",
"required": "20",
"cate_cd": "1",
"cate_nm": "TEST",
"icon_app_url": "http://127.0.0.1/msp-admin/.",
"icon_app_bic_url": "http://127.0.0.1/msp-admin/img/8ad72197-7f7e-4127-906b-d2c567a58851.png",
"app_ver": "0.0.1",
"bin_url": "http://127.0.0.1/msp-admin/apk/1fd63af6-42bc-4fda-9c7a-80b37b31bacf.apk",
"bin_size": 15,
"reg_dttm": "2024-02-16 10:26:23",
"dl_cnt": 1,
"install_type": "F",
"install_data": ""
}
]
}
}
AppStore에 등록된 APP 상세 정보를 조회한다
Method: POST
URL: http://{host}:{port}/{context}/api/appinfo/get
Headers:
Request Body
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | Array | M | ||
| body | app_no | String | M | 앱일련번호 |
{
"head": {},
"body": {
"app_no": "1"
}
}
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 | |
|---|---|---|---|---|---|
| head | result_code | String | M | 처리 응답 결과 코드 | |
| result_msg | String | M | 처리 응답 결과 메시지 | ||
| body | ResultCd | String | M | 결과 코드 | |
| ResultMsg | String | M | 결과 메시지 | ||
| icon_app_bic_url | String | M | 큰아이콘URL(등록된 아이콘이 없으면 default 제공) | ||
| icon_app_url | String | M | 작은아이콘URL(등록된 아이콘이 없으면 default 제공) | ||
| package_nm | String | M | 패키지명 | ||
| ios_dist_type | String | M | 배포 타입 | ||
| required | String | M | 필수여부(10. 필수, 20.일반) | ||
| cate_nm | String | M | 카테고리명 | ||
| bin_no | String | M | 바이너리 일련번호 | ||
| url_scheme | String | M | 호출 URL | ||
| cate_cd | String | M | 카테고리코드 | ||
| dl_cnt | String | M | 다운로드 횟수 | ||
| app_ver | String | M | 앱버전 | ||
| app_nm | String | M | 앱이름 | ||
| con_detail_img | Array | M | 미리보기(등록된 미리보기가 없으면 default 제공) | ||
| img_url | String | M | 미리보기 이미지 URL | ||
| app_no | String | M | 앱일련번호 | ||
| app_desc | String | M | 앱설명 | ||
| reg_dttm | String | M | 등록일 | ||
| app_id | String | M | 앱아이디 | ||
| bin_url | String | M | 앱설치파일경로 | ||
| bin_size | String | M | 앱설치파일크기 | ||
| install_type | String | M | 설치타입 (F:파일, A:앱스토어, B:브라우저) | ||
| install_data | String | M | 설치정보 | ||
{
"head": {
"result_msg": "Success",
"result_code": "200"
},
"body": {
"ResultCd": "0",
"ResultMsg": "App 상세조회 완료",
"icon_app_bic_url": "http://127.0.0.1/msp-admin/.",
"icon_app_url": "http://127.0.0.1/msp-admin/.",
"package_nm": "hello",
"ios_dist_type": null,
"required": "10",
"cate_nm": "TEST",
"bin_no": "4",
"url_scheme": null,
"cate_cd": "2",
"dl_cnt": 2,
"app_ver": "0.0.2",
"app_nm": "hello",
"con_detail_img": [],
"app_no": "1",
"app_desc": null,
"reg_dttm": "2023-09-20 19:14:51.0",
"app_id": "1",
"bin_url": "http://127.0.0.1/msp-admin/apk/1fd63af6-42bc-4fda-9c7a-80b37b31bacf.apk",
"bin_size": 15,
"install_type": "F",
"install_data": ""
}
}
해당 상위코드 아래 카테고리 목록을 조회한다.
Method: POST
URL: http://{host}:{port}/{context}/api/category/list
Headers:
Request Body
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | Array | M | ||
| body | parent_cate_cd | String | M | 상위 카테고리코드 |
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 | |
|---|---|---|---|---|---|
| head | result_code | String | M | 처리 응답 결과 코드 | |
| result_msg | String | M | 처리 응답 결과 메시지 | ||
| body | list | Array | M | ||
| cate_cd | String | M | 카테고리코드 | ||
| cate_nm | String | M | 카테고리명 | ||
{
"head": {},
"body": {
"parent_cate_cd": "STORE"
}
}
{
"head": {
"result_msg": "Success",
"result_code": "200"
},
"body": {
"list": [
{
"cate_cd": "2",
"cate_nm": "TEST"
}
]
}
}
APP 다운로드 후 다운로드 이력을 저장한다
Method: POST
URL: http://{host}:{port}/{context}/api/download/add
Headers:
Request Body
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | screen_id | String | M | 화면 스크린아이디 |
| system_name | String | M | 시스템명 | |
| phone_no | String | M | 핸드폰번호 | |
| app_version | String | M | 앱버전 | |
| appid | String | M | 앱아이디 | |
| device_md | String | M | 단말기 모델 | |
| device_id | String | M | 단말기 아이디 | |
| app_name | String | M | 앱이름 | |
| callback_request_data_flag | String | M | HTTP 요청 데이터를 응답 데이터에 포함시켜 수신할지에 대한 여부 | |
| system_version | String | M | 단말 OS 버전 | |
| user_id | String | M | 사용자 아이디 | |
| user_name | String | M | 사용자명 | |
| body | emp_no | String | M | 사원번호 |
| app_id | String | M | 앱아이디 | |
| bin_no | String | M | 바이너리 일련번호 | |
| cuid | String | M | 고객고유식별번호 예) 도시철도 : emp_no |
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | result_code | String | M | 처리 응답 결과 코드 |
| result_msg | String | M | 처리 응답 결과 메시지 | |
| body | Array | M |
{
"head": {
"screen_id": "0",
"system_name": "Android",
"phone_no": "1234567890",
"app_version": "0",
"appid": "kr.co.morpheus.mobile1",
"device_md": "SM-N900S",
"device_id": "257630051275603",
"app_name": "Morpheus",
"callback_request_data_flag": "n",
"system_version": "19",
"user_id": "user",
"user_name": "name"
},
"body": {
"emp_no": "1",
"app_id": "kr.co.morpheus.mobile1",
"bin_no" : "4",
"cuid": "0001"
}
}
{
"head": {
"result_code": "200",
"result_msg": "Success"
},
"body": {
}
}
APP에서 사용자 로그인을 처리한다
Method: POST
URL: http://{host}:{port}/{context}/api/login/get
Headers:
Request Body
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | screen_id | String | M | 화면 스크린아이디 |
| system_name | String | M | 시스템명 | |
| phone_no | String | M | 핸드폰번호 | |
| app_version | String | M | 앱버전 | |
| appid | String | M | 앱아이디 | |
| device_md | String | M | 단말기 모델 | |
| device_id | String | M | 단말기 아이디 | |
| app_name | String | M | 앱이름 | |
| callback_request_data_flag | String | M | HTTP 요청 데이터를 응답 데이터에 포함시켜 수신할지에 대한 여부 | |
| system_version | String | M | 단말 OS 버전 | |
| user_id | String | M | 사용자 아이디 | |
| user_name | String | M | 사용자명 | |
| body | emp_no | String | M | 사원번호 |
| user_id | String | M | 사용자 ID | |
| user_pw | String | M | 사용자 패스워드 |
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | result_code | String | M | 처리 응답 결과 코드 |
| result_msg | String | M | 처리 응답 결과 메시지 | |
| body | EMP_NO | String | M | 사원번호 |
| EMP_NM | String | M | 사원명 | |
| MSG | String | M | 처리 메시지 |
{
"head": {
"screen_id": "0",
"system_name": "Android",
"phone_no": "1234567890",
"app_version": "0",
"appid": "kr.co.morpheus.mobile1",
"device_md": "SM-N900S",
"device_id": "111111223333338",
"app_name": "Morpheus",
"callback_request_data_flag": "n",
"system_version": "19",
"user_id": "user",
"user_name": "name"
},
"body": {
"emp_no": "1",
"user_id": "1",
"user_pw" : "1234"
}
}
{
"head": {
"result_code": "200",
"result_msg": "OK"
},
"body": {
"EMP_NO": "1",
"EMP_NM": "11",
"MSG": "로그인에 성공 했습니다."
}
}
사용자의 단말기 목록을 조회한다
Method: POST
URL: http://{host}:{port}/{context}/api/device/get
Headers:
Request Body
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | device_id | String | M | 단말기 고유번호 |
| body | emp_no | String | M | 사원번호 |
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 | |
|---|---|---|---|---|---|
| head | result_code | String | M | 처리 응답 결과 코드 | |
| result_msg | String | M | 처리 응답 결과 메시지 | ||
| body | list | Array | M | ||
| use_fg | String | M | 단말기 사용여부 | ||
| device_nm | String | M | 단말기 모델명 | ||
| os_nm | String | M | 운영체제 | ||
| device_uuid | String | M | 단말기 고유번호 | ||
| last_date | String | M | 마지막 접속일 | ||
{
"head": {
"device_id": "111111223333338"
},
"body": {
"emp_no" : "1"
}
}
{
"head": {
"result_msg": "Success",
"result_code": "200"
},
"body": {
"list": [
{
"use_fg": "P",
"device_nm": "SM-N960F",
"os_nm": "Android",
"device_uuid": "111111223333338",
"last_date": "2024.01.18 14:04"
}
]
}
}
사용자의 단말기를 사용 중지 처리한다
Method: POST
URL: http://{host}:{port}/{context}/api/device/disable
Headers:
Request Body
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | Array | M | ||
| body | emp_no | String | M | 사원번호 |
| device_uuid | String | M | 단말기 고유번호 |
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | result_code | String | M | 처리 응답 결과 코드 |
| result_msg | String | M | 처리 응답 결과 메시지 | |
| body | Array | M |
{
"head": {
},
"body": {
"emp_no" : "1",
"device_uuid": "257630051275603"
}
}
{
"head": {
"result_code": "200",
"result_msg": "OK"
},
"body": {
}
}
스토어 공지사항을 조회한다
Method: POST
URL: http://{host}:{port}/{context}/api/notice/get
Headers:
Request Body
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 |
|---|---|---|---|---|
| head | Array | M | ||
| body | page_num | String | M | 페이지 번호 |
| page_size | String | M | 페이지 목록 크기 |
| JSON KEY | 파라미터 | 타입 | 필수여부 | 설명 | |
|---|---|---|---|---|---|
| head | result_code | String | M | 처리 응답 결과 코드 | |
| result_msg | String | M | 처리 응답 결과 메시지 | ||
| body | list | Array | M | ||
| board_IDX | String | M | 글 번호 | ||
| board_TYPE | String | M | 게시판 타입 | ||
| board_DETAIL_TYPE | String | M | 게시판 상세타입 | ||
| board_DETAIL_NAME | String | M | 게시판 상세이름 | ||
| board_TITLE | String | M | 게시판 제목 | ||
| board_CONTENT | String | M | 게시판 내용 | ||
| secret_YN | String | M | 공개 여부 | ||
| ref | String | M | 계층그룹 최상위부모 BOARD_IDX | ||
| rnum | String | M | 게시글(공지사항) 순번 | ||
| tot_CNT | String | M | 게시글(공지사항) 개수 | ||
| svc_ID | String | M | 서비스 ID | ||
| hit | String | M | 조회수 | ||
| use_YN | String | M | 사용유무 | ||
| reg_ID | String | M | 등록자 ID | ||
| reg_DT | String | M | 등록일자 | ||
| mod_DT | String | M | 수정일자 | ||
| mod_ID | String | M | 수정자 ID | ||
| stp | Integer | M | 계층별 단계 | ||
| lvl | Integer | M | 레벨 | ||
{
"head": {},
"body": {
"page_num": "1",
"page_size": "1"
}
}
{
"head": {
"result_msg": "Success",
"result_code": "200"
},
"body": {
"list": [
{
"board_IDX": "19",
"board_TYPE": "NOTICE",
"board_DETAIL_TYPE": "10",
"board_DETAIL_NAME": "공지",
"board_TITLE": "공지제목",
"board_CONTENT": "공지 내용입니다",
"secret_YN": "Y",
"ref": "19",
"rnum": "1",
"tot_CNT": "4",
"svc_ID": "2",
"hit": "5",
"use_YN": "Y",
"reg_ID": "admin",
"reg_DT": "2023.06.13",
"mod_DT": null,
"mod_ID": null,
"stp": 0,
"lvl": 0
}
]
}
}