저장소 API
GitLab의 Git 저장소에 대한 REST API 문서.
이 API를 사용하여 Git 저장소 를 관리합니다. 프로젝트의 모든 저장소 트리 목록 조회 # 지정된 프로젝트의 모든 저장소 파일 및 디렉토리를 반환합니다. 저장소가 공개적으로 접근 가능한 경우 인증 없이 이 엔드포인트에 접근할 수 있습니다. 이 명령은 본질적으로 git ls-tree 명령과 동일한 기능을 제공합니다. 자세한 내용은 Git 내부 문서의 트리 오브젝트 를 참조하세요. Warning GitLab 17.7은 요청된 경로를 찾을 수 없을 때의 오류 처리 동작을 변경합니다. 이 엔드포인트는 이제 상태 코드 404 Not Found 를 반환합니다. 이전에는 상태 코드가 200 OK 였습니다. 구현이 누락된 경로에 대해 빈 배열을 포함한 200 상태 코드를 수신하는 것에 의존하는 경우, 새로운 404 응답을 처리하도록 오류 처리를 업데이트해야 합니다. GET /projects/:id/repository/tree 지원되는 속성: 속성 유형 필수 여부 설명 id 정수 또는 문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로 . page_token 문자열 아니요 다음 페이지를 가져올 트리 레코드 ID. 키셋 페이지네이션에서만 사용됨. pagination 문자열 아니요 keyset 이면 키셋 기반 페이지네이션 방법 사용. path 문자열 아니요 저장소 내의 경로. 하위 디렉토리 내용을 가져오는 데 사용. per_page 정수 아니요 페이지당 표시할 결과 수. 지정하지 않으면 기본값 20 . 자세한 내용은 페이지네이션 참조. recursive 불리언 아니요 true 이면 재귀적 트리를 가져옴. 기본값 false . ref 문자열 아니요 저장소 브랜치 또는 태그 이름. 지정하지 않으면 기본 브랜치 사용. 성공 시 200 OK 및 트리 오브젝트 배열을 반환합니다. 요청 예시: curl --header "PRIVATE-TOKEN: <your_access_token>" \ --url "https://gitlab.example.com/api/v4/projects/13083/repository/tree" 응답 예시: [ { "id" : "a1e8f8d745cc87e3a9248358d9352bb7f9a0aeba" , "name" : "html" , "type" : "tree" , "path" : "files/html" , "mode" : "040000" } , { "id" : "4535904260b1082e14f867f7a24fd8c21495bde3" , "name" : "images" , "type" : "tree" , "path" : "files/images" , "mode" : "040000" } , { "id" : "31405c5ddef582c5a9b7a85230413ff90e2fe720" , "name" : "js" , "type" : "tree" , "path" : "files/js" , "mode" : "040000" } , { "id" : "cc71111cfad871212dc99572599a568bfe1e7e00" , "name"
