권한
요청으로 할 수 있는 일은 API 키나 앱 연결의 API 권한, 그리고 워크스페이스와 프로젝트에서의 내 역할로 정해집니다.
API 권한
각 엔드포인트의 레퍼런스 페이지에 필요한 API 권한이 표시됩니다. 키나 연결은 API 권한이 허용하는 엔드포인트만 호출할 수 있습니다. API 권한이 없으면 Ping만 호출할 수 있습니다.
| API 권한 | 허용하는 작업 |
|---|---|
projects:read | 프로젝트 검색과 조회, 보관 프로젝트와 삭제 예정 프로젝트 목록 |
projects:write | 프로젝트 생성, 수정, 보관, 보관 해제, 삭제 예약과 예약 취소 |
folders:read | 폴더 목록과 조회 |
folders:write | 폴더 생성, 수정, 삭제 |
files:read | 파일 목록과 조회, AI로 생성한 파일의 AI 작업 조회 |
files:write | 파일 업로드, 수정, 리뷰 태그 변경, 삭제 |
files:download | 파일 다운로드 URL 발급 |
ai:generate | AI 모델 목록, AI 파일 생성과 예약 크레딧 예측, AI 생성 첨부 업로드 |
comments:read | 댓글, 답글, 리액션 목록과 조회 |
comments:write | 댓글, 리액션, 댓글 첨부 파일 생성, 수정, 삭제 |
comments:download | 댓글 첨부 파일 다운로드 URL 발급 |
workspace-members:read | 워크스페이스 멤버 목록 |
project-members:read | 프로젝트 멤버 목록 |
project-members:write | 프로젝트 멤버 추가, 수정, 제거 |
access-links:read | 액세스 링크 목록과 조회 |
access-links:write | 액세스 링크 생성, 수정, 삭제 |
access-links:read.key | 액세스 링크의 accessKey 확인. 이 API 권한이 없으면 accessKey는 null |
skills:read | 스킬 목록과 조회, 스킬 버전 다운로드 |
skills:write | 스킬 생성, 수정, 삭제와 스킬 버전 생성, 삭제 |
schedules:read | 프로젝트 일정 목록과 조회 |
schedules:write | 프로젝트 일정 생성, 수정, 삭제 |
usage:read | 워크스페이스 사용량 조회. credits:read가 있으면 크레딧 현황도 반환 |
credits:read | 플랜 크레딧, 구매 크레딧, 멤버별 크레딧 목록. usage:read와 함께 있으면 워크스페이스 사용량에 크레딧 현황도 반환 |
역할
요청은 내 권한으로 동작합니다. 그래서 YouViCo 앱에서 열 수 있는 프로젝트에 똑같이 접근합니다.
- 내가 참여한 프로젝트
- 워크스페이스 전체에 공개된 프로젝트
- 워크스페이스 소유자나 관리자라면 워크스페이스의 모든 프로젝트
- 다른 워크스페이스가 내 워크스페이스와 연결한 프로젝트
프로젝트 역할이나 워크스페이스 역할이 필요한 엔드포인트는 레퍼런스 페이지에 허용된 역할이 표시됩니다.
일부 작업은 항목을 생성한 사람만 할 수 있습니다.
- 댓글 수정과 삭제: 작성자
- 파일 업로드 완료: 업로드를 시작한 사람
- AI 생성 첨부 업로드 완료: 업로드를 시작한 사람
- 댓글 첨부 파일 업로드 완료, 취소, 삭제: 업로드한 사람
제한 공개 파일
제한된 리뷰어는 자신에게 공개된 파일(allowRestricted가 true)만 볼 수 있습니다.
프로젝트에 참여하지 않고 워크스페이스 역할로 프로젝트에 접근한 경우도 같습니다.
플랜 기능
AI 파일 생성과 스킬은 해당 기능이 포함된 플랜에서만 사용할 수 있습니다.
보관된 프로젝트
보관된 프로젝트는 보관을 해제할 때까지 읽기 전용입니다. 다운로드 URL 발급, 프로젝트 멤버 제거, 액세스 링크 삭제는 계속 할 수 있습니다.