Progress Table API

캠페인 진행 상황 관리 API입니다.

Base URL: /ai/progress-table

인증 정보

항목	값
인증 필요	일부 필요
인증 방식	JWT Bearer Token

엔드포인트 목록

진행 항목 관리

메서드	경로	설명	인증
`POST`	`/ai/progress-table/items/admin`	진행 항목 생성	불필요
`GET`	`/ai/progress-table/item/{id}`	캠페인 진행 항목 조회	필요
`GET`	`/ai/progress-table/items/{id}`	특정 항목 조회	불필요
`DELETE`	`/ai/progress-table/items/{id}`	항목 삭제	불필요

매칭 상태

메서드	경로	설명	인증
`PUT`	`/ai/progress-table/items/{id}/user/matching-status`	사용자 매칭 상태 변경	불필요
`PUT`	`/ai/progress-table/items/{id}/admin/matching-status`	관리자 매칭 상태 변경	불필요
`PUT`	`/ai/progress-table/items/bulk/user/matching-status`	사용자 대량 매칭 상태	필요
`PUT`	`/ai/progress-table/items/bulk/admin/matching-status`	관리자 대량 매칭 상태	불필요

검수 관리

메서드	경로	설명	인증
`PUT`	`/ai/progress-table/items/bulk/admin/ai-check`	AI 체크 상태 대량 업데이트	불필요
`PUT`	`/ai/progress-table/items/bulk/user/ai-check`	사용자 AI 체크 상태 대량 업데이트	필요
`PUT`	`/ai/progress-table/items/bulk/user/person-check`	기업 최종 검수 대량 업데이트	필요
`PUT`	`/ai/progress-table/items/{id}/ai-check-ready`	AI 체크 준비 상태 업데이트	불필요
`PUT`	`/ai/progress-table/reviews/bulk`	벌크 1차/2차 검수 처리	불필요

배송 관리

메서드	경로	설명	인증
`PUT`	`/ai/progress-table/items/{id}/delivery-status`	배송 상태 업데이트	불필요
`PUT`	`/ai/progress-table/items/{id}/tracking-number`	추적 번호 업데이트	불필요
`PUT`	`/ai/progress-table/application/delivery/tracking`	운송장 번호 저장/수정	필요
`PUT`	`/ai/progress-table/application/delivery/status/bulk`	배송 상태 일괄 변경	필요
`GET`	`/ai/progress-table/application/{applicationId}/delivery`	배송 정보 조회	불필요
`GET`	`/ai/progress-table/collab/{collabNo}/delivery-addresses`	선정된 인플루언서 배송지 목록	필요

기타

메서드	경로	설명	인증
`PUT`	`/ai/progress-table/items/{id}/admin/upload-url`	업로드 URL 업데이트	불필요
`PUT`	`/ai/progress-table/items/{id}/admin/campaign-result`	캠페인 결과 URL 업데이트	불필요
`PUT`	`/ai/progress-table/items/{id}/admin/campaign-result-status`	캠페인 결과 상태 업데이트	불필요
`PUT`	`/ai/progress-table/items/{id}/bid-price`	입찰 가격 업데이트	불필요
`PATCH`	`/ai/progress-table/note/{id}`	협업 노트 업데이트	필요
`POST`	`/ai/progress-table/item/please-redo`	재요청	필요
`POST`	`/ai/progress-table/final-submissions/bulk`	벌크 최종 제출물 조회	불필요

API 상세

진행 항목 생성

새로운 진행 상황 항목을 생성합니다.

HTTP 요청

POST /ai/progress-table/items/admin
Content-Type: application/json

Request Body

{
  "collabNo": 123,
  "influenceId": "user123",
  "applicationId": 456,
  "matchingStatus": "PENDING"
}

응답

성공 응답 (201 Created)

{
  "status": 201,
  "code": null,
  "message": "새로운 진행 상황 항목이 생성되었습니다.",
  "data": {
    "id": 1,
    "collabNo": 123,
    "matchingStatus": "PENDING"
  }
}

캠페인 진행 항목 조회

기업 대시보드용 캠페인 진행 항목을 조회합니다.

HTTP 요청

GET /ai/progress-table/item/{id}
Authorization: Bearer {access_token}

Path Parameters

파라미터	타입	필수	설명
`id`	`long`	예	캠페인 ID

응답

성공 응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "캠페인 진행 상황 항목 조회가 완료되었습니다.",
  "data": {
    "campaign": {
      "collabNo": 123,
      "title": "여름 뷰티 캠페인"
    },
    "progressItems": [
      {
        "id": 1,
        "influenceName": "인플루언서A",
        "matchingStatus": "MATCHED",
        "deliveryStatus": "DELIVERED",
        "reviewStatus": "APPROVED"
      }
    ]
  }
}

사용자 매칭 상태 변경

사용자가 매칭 상태를 변경합니다.

HTTP 요청

PUT /ai/progress-table/items/{id}/user/matching-status?matchingStatus={status}

Path Parameters

파라미터	타입	필수	설명
`id`	`long`	예	진행 항목 ID

Query Parameters

파라미터	타입	필수	설명
`matchingStatus`	`string`	예	매칭 상태

매칭 상태

상태	설명
`PENDING`	대기 중
`MATCHED`	매칭됨
`REJECTED`	거절됨
`COMPLETED`	완료

대량 매칭 상태 업데이트 (사용자)

여러 항목의 매칭 상태를 한번에 업데이트합니다.

HTTP 요청

PUT /ai/progress-table/items/bulk/user/matching-status
Authorization: Bearer {access_token}
Content-Type: application/json

Request Body

{
  "itemIds": [1, 2, 3, 4, 5],
  "matchingStatus": "MATCHED"
}

응답

성공 응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "대량 매칭 상태 업데이트가 완료되었습니다.",
  "data": [1, 2, 3, 4, 5]
}

벌크 1차/2차 검수 처리

여러 신청자의 검수 상태를 한번에 승인/반려 처리합니다.

1차 검수 승인 시: 2차 검수 라운드 생성 + Phase를 SECOND_REVIEW로 변경
2차 검수 승인 시: 업로드 허용 + Phase를 UPLOAD_SETTLEMENT로 변경
반려 시: 재제출 상태로 변경 (Phase 유지)

HTTP 요청

PUT /ai/progress-table/reviews/bulk
Content-Type: application/json

Request Body

{
  "applicationIds": [1, 2, 3],
  "action": "APPROVE",
  "reviewRound": 1
}

action 옵션

액션	설명
`APPROVE`	승인
`REJECT`	반려

운송장 번호 저장/수정

applicationId로 배송 정보를 저장하거나 수정합니다.

HTTP 요청

PUT /ai/progress-table/application/delivery/tracking
Authorization: Bearer {access_token}
Content-Type: application/json

Request Body

{
  "applicationId": 123,
  "courier": "CJ대한통운",
  "trackingNumber": "1234567890"
}

배송 상태 일괄 변경

여러 신청의 배송 상태를 일괄 변경합니다.

HTTP 요청

PUT /ai/progress-table/application/delivery/status/bulk
Authorization: Bearer {access_token}
Content-Type: application/json

Request Body

{
  "applicationIds": [1, 2, 3],
  "deliveryStatus": "SHIPPED"
}

배송 상태

상태	설명
`beforeDelivery`	배송 전
`shipping`	배송 중
`delivered`	배송 완료

선정된 인플루언서 배송지 목록 조회

캠페인에서 선정된 인플루언서들의 배송지 정보를 조회합니다. 다운로드용입니다.

HTTP 요청

GET /ai/progress-table/collab/{collabNo}/delivery-addresses
Authorization: Bearer {access_token}

협업 노트 업데이트

진행 항목의 협업 노트를 업데이트합니다.

HTTP 요청

PATCH /ai/progress-table/note/{id}
Authorization: Bearer {access_token}
Content-Type: application/json

Request Body

{
  "collaborationNote": "특별 요청 사항: 제품 클로즈업 추가 필요"
}

재요청

콘텐츠 재제출을 요청합니다.

HTTP 요청

POST /ai/progress-table/item/please-redo
Authorization: Bearer {access_token}
Content-Type: application/json

Request Body

{
  "itemIds": [1, 2, 3],
  "rejectReason": "영상 품질 미달"
}

사용 예시

대량 매칭 상태 업데이트

curl -X PUT https://api.glowb.io/ai/progress-table/items/bulk/user/matching-status \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "itemIds": [1, 2, 3],
    "matchingStatus": "MATCHED"
  }'

벌크 검수 처리

curl -X PUT https://api.glowb.io/ai/progress-table/reviews/bulk \
  -H "Content-Type: application/json" \
  -d '{
    "applicationIds": [1, 2, 3],
    "action": "APPROVE",
    "reviewRound": 1
  }'

Progress Table API

On this page