getDeviceCapabilities

GET

/api/v1/devices/{device_id}/capabilities

const url = 'https://dev.api.endueos.com/api/v1/devices/res_01J9ZK3Q8M4XW7D2N5R6T0V1BC/capabilities';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://dev.api.endueos.com/api/v1/devices/res_01J9ZK3Q8M4XW7D2N5R6T0V1BC/capabilities \
  --header 'Authorization: Bearer <token>'

Fresh capability report. Read-only system call: no billing, command journal or background polling.

인증

파라미터

경로 파라미터

device_id

필수

Device 의 id — Resource 와 같은 res_ 다 (v0.1.0 이 이미 냈다).

string

/^res_[0-9A-HJKMNP-TV-Z]{26}$/

예시

res_01J9ZK3Q8M4XW7D2N5R6T0V1BC

응답

200

성공.

application/json

object

data

필수

object

interface_version

필수

string

허용 값: 1.0

operations

필수

Array<object>

object

type

필수

string

허용 값: files.list files.stat files.mkdir files.copy files.move files.delete text.read text.write text.edit files.upload files.download device.info capabilities.get execution.run execution.list execution.output execution.wait execution.stop screen.capture input.click input.type input.scroll input.key apps.list apps.launch apps.stop system.status clipboard.read clipboard.write notifications.show notifications.cancel network.info network.probe settings.get settings.set

supported

필수

boolean

reason

필수

Any of:

string
null

string

constraints

object

allowed_programs

Array<string>

target_modes

Array<string>

허용 값: coordinates selector reference accessibility focused screen

key_names

Array<string>

supports_modifiers

boolean

supports_char_keys

boolean

supports_revisions

boolean

full_page

boolean

roots

필수

Array<object>

object

root_id

필수

string

허용 값: workspace transfers

label

필수

string

writable

필수

boolean

hierarchical

필수

boolean

limits

필수

Per-operation limits; absent fields are unknown, not unlimited.

object

meta

필수

object

request_id

필수

string

timestamp

필수

string format: date-time

duration

서버 처리 시간(ms).

integer format: int32

예시

{
  "data": {
    "interface_version": "1.0",
    "operations": [
      {
        "type": "files.list",
        "constraints": {
          "target_modes": [
            "coordinates"
          ]
        }
      }
    ],
    "roots": [
      {
        "root_id": "workspace"
      }
    ]
  }
}

401

인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.

404

없거나 내 것이 아니다 — *_NOT_FOUND. 본문은 오류 봉투.

409

지금 상태와 충돌한다 — 코드는 위 설명을 본다. 본문은 오류 봉투.

422

형식은 맞지만 할 수 없다 — 코드는 위 설명을 본다. 본문은 오류 봉투.

429

한도를 넘었다 — Retry-After 초 뒤에 다시. 본문은 오류 봉투.

500

서버 오류 — INTERNAL_ERROR. 본문은 오류 봉투.

503

의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.

504

결과를 알 수 없다 — COMMAND_OUTCOME_UNKNOWN, 같은 request_id 로 다시. 본문은 오류 봉투.