Connect Devices

파일 전송은 연결된 장비(device) 사이에서 일어납니다. 장비를 등록하고, 연결 상태를 확인하고, 필요 시 에이전트를 업데이트합니다.

일반적인 온보딩 흐름:

code

설치파일 다운로드 → 에이전트 설치·등록 → 장비 목록에 표시 → 연결 상태 확인

설치파일 다운로드

POST /api/device/install — 에이전트 설치파일 다운로드

대상 OS의 에이전트 설치 파일을 받습니다. 설치된 에이전트가 서버에 연결되면 장비 목록에 나타납니다.

장비 목록 조회

GET /api/device — 전체 장비 목록 조회

bash

curl "https://exacoola.innorix.com/api/device?page=1&size=20" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>"

쿼리 파라미터:

파라미터	타입	설명
`page`	integer	페이지 번호
`size`	integer	페이지당 결과 수
`deviceGroupId`	string	장비 그룹 ID
`searchKeyword`	string	검색 키워드
`sort`	string	정렬 (예: `field:asc`)

응답:

json

{
  "status_code": 200,
  "message": "success",
  "data": {
    "items": [
      { "deviceId": "dev_a1", "name": "seoul-node-01", "os": "linux", "status": "online" },
      { "deviceId": "dev_b2", "name": "hanoi-node-02", "os": "windows", "status": "offline" }
    ],
    "total": 2
  }
}

연결 상태 / 상세 조회

목적	메서드 · 경로
연결 상태 조회	`GET /api/device/connectivity/{deviceId}`
상세 정보 조회	`GET /api/device/{device_id}/detail`
정보 업데이트	`PATCH /api/device/{device_id}`
에이전트 업데이트	`PATCH /api/device/updateAgent/{deviceId}`

파일 관리 (탐색기)

장비의 파일/폴더를 원격으로 조작합니다. uuid는 동일 탐색 세션을 묶는 식별자입니다.

목적	메서드 · 경로
폴더 생성	`POST /api/explorer/createFolder/{deviceId}`
이름 변경	`POST /api/explorer/renameFile/{deviceId}`
복사	`POST /api/explorer/copyFile/{deviceId}`
삭제	`POST /api/explorer/removeFile/{deviceId}`
이동(잘라내기)	`POST /api/explorer/cutFile/{deviceId}`
탐색 취소	`POST /api/explorer/cancelSearch/{deviceId}`

폴더 생성 — POST /api/explorer/createFolder/{deviceId}

bash

curl -X POST https://exacoola.innorix.com/api/explorer/createFolder/dev_a1 \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>" \
  -H "Content-Type: application/json" \
  -d '{ "path": "/data/export/new-folder", "uuid": "" }'

이름 변경 — POST /api/explorer/renameFile/{deviceId}

bash

curl -X POST https://exacoola.innorix.com/api/explorer/renameFile/dev_a1 \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "report_final.csv", "path": "/data/export/report.csv", "uuid": "" }'

복사 — POST /api/explorer/copyFile/{deviceId}

bash

curl -X POST https://exacoola.innorix.com/api/explorer/copyFile/dev_a1 \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>" \
  -H "Content-Type: application/json" \
  -d '{ "path": "/data/backup", "overwrite": false, "uuid": "", "listFiles": ["/data/export/report.csv"] }'

삭제 — POST /api/explorer/removeFile/{deviceId}

bash

curl -X POST https://exacoola.innorix.com/api/explorer/removeFile/dev_a1 \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "x-workspace-id: <WORKSPACE_ID>" \
  -H "Content-Type: application/json" \
  -d '{ "listFiles": ["/data/export/old.csv"], "uuid": "" }'