SaaS API제출 링크 (매직 링크)
GET /submit-link/{token}
링크 컨텍스트 조회 (무인증)
링크 컨텍스트 조회
토큰을 검증하고, 해당 신청의 제출 컨텍스트(검수 라운드 목록)를 반환합니다. 링크 진입 시 가장 먼저 호출합니다.
무인증 엔드포인트 — JWT 없이 토큰만으로 접근합니다. (/submit-link/**는 permitAll)
HTTP 요청
GET /submit-link/{token}Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
token | string | 예 | 발급받은 제출 링크 토큰 |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "조회 완료",
"data": {
"applicationId": 100,
"reviewRounds": [
{ "reviewId": 50, "reviewRound": 1, "status": "REVIEWING" },
{ "reviewId": 51, "reviewRound": 2, "status": "PENDING" }
]
}
}Response Body 스키마
| 필드명 | 타입 | 설명 |
|---|---|---|
applicationId | long | 제출 대상 캠페인 신청 ID |
reviewRounds | array | 신청의 검수 라운드 목록 |
reviewRounds[].reviewId | long | 검수 라운드 ID (완료 콜백에 사용) |
reviewRounds[].reviewRound | int | 검수 차수 (1=1차, 2=2차) |
reviewRounds[].status | string | 검수 상태 |
최종제출물 가능 여부는 신청 단계로 판단되며, 컨텍스트에는 검수 라운드만 노출됩니다.
최종제출은 POST /submit-link/{token}/complete/final을 직접 호출합니다.
에러 응답
| 상황 | 상태 코드 | 메시지 |
|---|---|---|
| 토큰 없음 | 400 | 유효하지 않은 링크입니다. |
| 만료/사용됨/비활성 | 400 | 만료되었거나 사용할 수 없는 링크입니다. |