CLI

YouViCo CLI는 터미널에서 YouViCo를 빠르게 사용할 수 있는 도구입니다. 내부적으로 공식 JavaScript SDK를 사용하고, 명령 결과는 JSON으로 출력합니다.

설치

CLI는 Node.js 20 이상을 지원합니다.

npm install -g @youvico/cli

명령을 사용할 수 있는지 확인하세요.

youvico --help

인증

Settings -> API Keys 에서 API 키를 만든 뒤 로컬에 저장합니다.

youvico auth api

저장된 API 키는 0600 권한으로 ~/.config/youvico/config.json에 보관됩니다. 키는 CLI 출력에 표시되지 않습니다.

환경 변수로 API 키를 전달할 수도 있습니다.

YOUVICO_API_KEY=YOUR_API_KEY youvico project search --query="launch"

저장된 키를 확인하거나 삭제하려면 다음 명령을 사용하세요.

youvico auth status
youvico auth clear

클라이언트 설정

config 명령으로 클라이언트 옵션을 확인하거나 덮어쓸 수 있습니다.

youvico config get
youvico config set --base-url https://api.youvico.com
youvico config set --timeout-ms 30000
youvico config clear --base-url
youvico config clear --timeout-ms
youvico config clear

대표 예시

프로젝트 검색:

youvico project search --query="launch"

로컬 파일 업로드:

youvico file upload.file --project=bdbff5de-96d7-468f-9db0-85fe28bd6b62 --path=./launch.mp4 --name=launch.mp4

파일 댓글 목록:

youvico comment list --file=FX1234567890ABCD

엔드포인트별 명령은 해당 API 레퍼런스 페이지에서 예시 탭을 CLI로 전환해 확인하세요.

파일 업로드

로컬 파일 업로드는 youvico file upload.file을 사용하세요.

youvico file upload.file --project=bdbff5de-96d7-468f-9db0-85fe28bd6b62 --path=./launch.mp4 --name=launch.mp4

CLI는 SDK files.upload 헬퍼를 사용합니다. 멀티파트 업로드 시작, 각 파트 업로드, 업로드 완료까지 자동으로 처리합니다.

출력과 확인 프롬프트

명령 결과는 JSON으로 출력됩니다.

삭제 명령은 기본적으로 확인을 요청합니다. 스크립트에서 확인 프롬프트를 건너뛰려면 --yes를 전달하세요.

youvico file delete --id FX1234567890ABCD --yes

도움말 보기

명령 그룹이나 개별 명령에 --help를 사용할 수 있습니다.

youvico file --help
youvico file upload.file --help

API 레퍼런스 페이지에는 CLI, SDK, cURL 예시 탭이 포함되어 있습니다. 멀티파트 업로드 엔드포인트의 CLI 탭은 CLI에서 해당 엔드포인트를 직접 호출하지 않으므로 file upload.file 헬퍼 명령을 보여줍니다.