API Reference

Base URL: https://idp-api.letsur.ai

인증

Method	Path	설명	상태 코드
POST	/api/auth/sign-up	회원가입	201, 409
POST	/api/auth/login	로그인	200, 404
POST	/api/auth/logout	로그아웃	200

사용자

Method	Path	설명	상태 코드
GET	/api/users/me	현재 사용자	200, 401
GET	/api/users/me/repos	GitHub 저장소 목록	200, 404
GET	/api/users	전체 사용자 목록	200
GET	/api/users/{id}	사용자 조회	200, 404
DELETE	/api/users/{id}	사용자 삭제	200, 404

GitHub 연동

Method	Path	설명	상태 코드
GET	/api/account/providers/github	연결 상태 조회	200, 404
GET	/api/account/providers/github/link	OAuth URL 생성	200
POST	/api/account/providers/github/unlink	연결 해제	200, 404
GET	/api/account/providers/github/install	App 설치 시작	302
GET	/api/account/providers/github/callback	OAuth 콜백	302
GET	/api/account/providers/github/install/callback	App 설치 콜백	302

워크스페이스

Method	Path	설명	상태 코드
GET	/api/workspaces	목록	200
POST	/api/workspaces	생성	201, 404
GET	/api/workspaces/{id}	조회	200, 404
PUT	/api/workspaces/{id}	수정	200, 404
DELETE	/api/workspaces/{id}	삭제	200, 404
GET	/api/workspaces/{id}/members	멤버 목록	200, 404
POST	/api/workspaces/{id}/members	멤버 추가	201, 404, 409
DELETE	/api/workspaces/{id}/members/{userId}	멤버 제거	200, 404

프로젝트

Method	Path	설명	상태 코드
GET	/api/workspaces/{id}/projects	프로젝트 목록	200, 404
POST	/api/workspaces/{id}/projects	프로젝트 생성	201, 404
GET	/api/projects/{id}	프로젝트 조회	200, 404
PUT	/api/projects/{id}	프로젝트 수정	200, 404
DELETE	/api/projects/{id}	프로젝트 삭제	200, 404

환경변수

Method	Path	설명	상태 코드
GET	/api/projects/{id}/env-profiles	프로필 목록	200, 404
POST	/api/projects/{id}/env-profiles	프로필 생성	201, 404, 409
PUT	/api/projects/{id}/env-profiles/{envId}	프로필 수정	200, 404, 409
DELETE	/api/projects/{id}/env-profiles/{envId}	프로필 삭제	200, 404

배포

Method	Path	설명	상태 코드
GET	/api/projects/{id}/deployments	배포 목록	200, 404
POST	/api/projects/{id}/deploy	배포 트리거	201, 404, 409
GET	/api/deployments/{id}	배포 조회	200, 404
POST	/api/deployments/{id}/retry	배포 재시도	201, 404, 409

빌드

Method	Path	설명	상태 코드
GET	/api/projects/{id}/builds	빌드 목록	200, 404
GET	/api/builds/{id}	빌드 조회	200, 404
GET	/api/builds/{id}/logs	빌드 로그	200, 404, 422

로그 스트리밍

Method	Path	설명	Content-Type
GET	/api/projects/{id}/logs	런타임 로그	application/x-ndjson

웹훅

Method	Path	설명
POST	/api/webhook/builder/callback	빌드 완료 콜백
POST	/api/webhook/github	GitHub 이벤트 수신

에러 응답 규칙

코드	의미	설명
200/201	성공	정상 응답
302	리다이렉트	OAuth 콜백 흐름
400	잘못된 요청	재시도 불가
401	미인증	세션 만료 → 로그인 리다이렉트
404	미발견	리소스 없음
409	충돌	중복 리소스
422	처리 불가	아직 준비되지 않음