SaaS API구사스 제출 링크 (매직 링크)
구사스 제출 링크 (매직 링크) API
로그인 없이 토큰 링크로 구사스(legacy) 산출물을 업로드하는 API
구사스 제출 링크 (매직 링크) API
구사스(legacy SaaS) 캠페인에서, 관리자가 산출물 행에 대해 로그인 없이 올릴 수 있는 토큰 링크를 발급하면 크리에이터가 그 링크로 콘텐츠를 업로드할 수 있게 하는 기능입니다.
신사스 제출 링크와의 차이
- 대상 단위가 검수 라운드가 아니라
ProgressTable행(산출물 1건) 입니다. - 발급은 관리자 전용입니다(구사스 크리에이터는 로그인 개념이 없음).
- 완료 시 기존 관리자 업로드와 동일하게
ProgressTable.file기록 +uploadStatus=CREATING만 수행합니다(트랜스코딩 없음).
동작 원리
| 축 | 방식 |
|---|---|
| 접근(인증) | 로그인 대신 추측 불가능한 토큰으로 산출물 행을 식별 |
| 전송(업로드) | 파일은 브라우저에서 GCS로 직접 업로드(Resumable Signed URL) → 서버 미경유 |
| 반영 | 완료 콜백이 기존 ProgressTableService.updateFileUrl(id, url, "creating") 을 그대로 호출 |
토큰 정책
| 항목 | 정책 |
|---|---|
| 만료 | 제출 성공 시 즉시 만료(1회용) |
| 미사용 백스톱 | 한 번도 쓰지 않은 링크는 만료일(기본 7일) 경과 시 자동 만료 |
| 만료일 지정 | 관리자 발급 시 expiryDays로 직접 지정 가능 (1 ~ 365일) |
| 재발급 | 다시 올려야 하면 관리자가 새 링크를 발급 |
1회용입니다. 제출이 성공하면 토큰이 소진되어 더 이상 사용할 수 없습니다. 다시 업로드하려면 관리자가 새 링크를 발급해야 합니다.
전체 흐름
1. (관리자) 링크 발급 → https://app.glowb.io/legacy-submit/{token}
2. 크리에이터가 링크 진입 (로그인 X)
→ GET /ai/legacy-submit-link/{token} (컨텍스트 조회)
3. 파일 업로드 준비
→ POST /ai/legacy-submit-link/{token}/signed-url (GCS Resumable Signed URL 발급)
→ 브라우저가 GCS로 직접 업로드 (끊겨도 재개)
4. 제출 완료 콜백
→ POST /ai/legacy-submit-link/{token}/complete (ProgressTable.file 기록, 1회용 소진)엔드포인트 목록
링크 발급 (인증 필요)
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
POST | /ai/admin/legacy-submission-link/progress-items/{progressTableId} | 관리자 링크 발급 (만료일 지정 가능) | 필요 (관리자) |
무인증 제출 (토큰 인증)
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
GET | /ai/legacy-submit-link/{token} | 링크 컨텍스트 조회 | 토큰 |
POST | /ai/legacy-submit-link/{token}/signed-url | GCS Resumable Signed URL 발급 | 토큰 |
POST | /ai/legacy-submit-link/{token}/complete | 제출 완료 콜백 | 토큰 |
GCS Signed URL은 Resumable(재개 가능) 모드입니다.
브라우저는 발급받은 URL로 POST(헤더 x-goog-resumable: start)하여 세션 URI를 받고,
그 URI로 파일 바이트를 PUT 합니다. 업로드 중 네트워크가 끊겨도 끊긴 지점부터 재개할 수 있습니다.