프로젝트

프로젝트 API

FloopFloop 프로젝트를 프로그래밍 방식으로 관리합니다.

프로젝트 목록 조회

GET /api/v1/projects

인증된 사용자가 소유한 모든 프로젝트를 반환합니다.

쿼리 매개변수:

• teamId (선택 사항) — 팀 워크스페이스로 필터링

curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

프로젝트 생성

POST /api/v1/projects

새 프로젝트를 생성하고 AI 생성 파이프라인을 시작합니다.

요청 본문:

{
  "name": "My Project",          // required
  "subdomain": "my-project",     // required, lowercase
  "prompt": "Description...",    // required
  "botType": "app",              // optional: site, app, bot, api, internal
  "isAuthProtected": true,       // optional, default true
  "teamId": "uuid",              // optional, for team workspace
  "attachments": [               // optional
    {
      "key": "uploads/userId/fileId/file.png",
      "fileName": "file.png",
      "fileType": "image/png",
      "fileSize": 12345
    }
  ]
}

응답 (201):

{
  "data": {
    "project": { "id": "...", "name": "My Project", "status": "queued", ... },
    "deployment": { "id": "...", "version": 1, "status": "pending" }
  }
}

프로젝트 조회

GET /api/v1/projects/{projectId}

특정 프로젝트의 세부 정보를 반환합니다.

프로젝트 업데이트

PATCH /api/v1/projects/{projectId}

요청 본문 (모든 필드 선택 사항):

{
  "name": "New Name",
  "description": "Updated description",
  "isPublic": true,
  "isAuthProtected": false,
  "hasBranding": false
}

프로젝트 보관

DELETE /api/v1/projects/{projectId}

프로젝트를 보관하고 서브도메인을 해제합니다. AWS 리소스는 백그라운드에서 정리됩니다.

프로젝트 개선

POST /api/v1/projects/{projectId}/refine

라이브 프로젝트를 수정하기 위한 후속 지시 사항을 전송합니다.

{
  "message": "Add a contact form to the homepage",
  "codeEditOnly": false,         // optional, true for code-only edits (cheaper)
  "attachments": []              // optional
}

프로젝트가 현재 배포 중인 경우, 메시지는 대기열에 추가되어 현재 배포가 완료된 후 자동으로 처리됩니다.

대화 내역 조회

GET /api/v1/projects/{projectId}/conversations

배포 마커 및 대기 중인 메시지를 포함한 전체 대화 내역을 반환합니다.

라이브러리 탐색

GET /api/v1/library

쿼리 매개변수:

• botType — 유형별 필터링 (site, app, bot, api, internal)
• search — 이름 또는 설명으로 검색
• sort — newest (기본값) 또는 popular
• page — 페이지 번호 (기본값 1)
• limit — 페이지당 항목 수 (1-50, 기본값 20)

라이브러리 프로젝트 클론

POST /api/v1/library/{projectId}/clone

{ "subdomain": "my-clone" }

라이브러리에서 공개 프로젝트를 계정으로 클론합니다.