권한
요청으로 할 수 있는 일은 API 키나 앱 연결의 API 권한, 그리고 워크스페이스와 프로젝트에서의 내 역할로 정해집니다.
API 권한
각 엔드포인트의 레퍼런스 페이지에 필요한 API 권한이 표시됩니다. 키나 연결은 API 권한이 허용하는 엔드포인트만 호출할 수 있습니다. API 권한이 없으면 Ping만 호출할 수 있습니다.
| API 권한 | 허용하는 작업 |
|---|---|
projects:read | 프로젝트 검색과 조회 |
projects:write | 프로젝트 생성과 수정, 삭제 예약과 예약 취소 |
folders:read | 폴더 목록과 조회 |
folders:write | 폴더 생성, 수정, 삭제 |
files:read | 파일 목록과 조회 |
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 | 스킬 생성, 수정, 삭제와 스킬 버전 배포, 삭제 |
역할
요청은 나로서 동작하므로, 앱에서 열 수 있는 프로젝트에 똑같이 접근합니다.
- 내가 참여한 프로젝트
- 워크스페이스 전체에 공개된 프로젝트
- 워크스페이스 소유자나 관리자라면 워크스페이스의 모든 프로젝트
- 다른 워크스페이스가 내 워크스페이스와 연결한 프로젝트
프로젝트 역할이 필요한 엔드포인트는 레퍼런스 페이지에 허용된 역할이 표시됩니다.
일부 작업은 항목을 만든 사람만 할 수 있습니다.
- 댓글 수정과 삭제: 작성자
- 파일 업로드 완료: 업로드를 시작한 사람
- 댓글 첨부파일 업로드 완료, 취소, 삭제: 업로드한 사람
제한 공개 파일
제한된 리뷰어는 자신에게 공개된 파일(allowRestricted가 true)만 볼 수 있습니다. 프로젝트에 참여하지 않고 워크스페이스 역할로 연 경우도 같습니다.
플랜 기능
AI 파일 생성과 스킬은 해당 기능이 포함된 플랜에서만 사용할 수 있습니다.
보관된 프로젝트
보관된 프로젝트는 읽기 전용입니다. 다운로드 URL 받기, 프로젝트 멤버 제거, 액세스 링크 삭제는 계속 할 수 있습니다.