SaaS APIProgress Table
PUT /ai/progress-table/items/bulk/user/matching-status
사용자 대량 매칭 상태 업데이트
대량 매칭 상태 업데이트 (사용자)
여러 항목의 매칭 상태를 한번에 업데이트합니다.
CREATOR_MATCHING 단계 전환 조건
- 비즈니스/관리자 모두 초기 결제금액의 80% 이상 예산이 사용된 경우에만
CREATOR_MATCHING(협업 상세 협의)으로 전환 - 80% 미달 시 매칭 상태 변경 자체는 정상 처리되나 단계 전환은 보류
- 응답의
budgetWarning: true이면 80% 미달 상태 - 관리자가 단계를 강제 전환하려면
PATCH /ai/admin/dashboard/{campaignNo}/substep사용
HTTP 요청
PUT /ai/progress-table/items/bulk/user/matching-status
Authorization: Bearer {access_token}
Content-Type: application/jsonRequest Body
{
"collabId": 123,
"itemIds": [1, 2, 3, 4, 5],
"matchingStatus": "proposal"
}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "대량 매칭 상태 업데이트가 완료되었습니다.",
"data": {
"success": true,
"updatedItemIds": [1, 2, 3, 4, 5],
"budgetWarning": false,
"budgetUsagePercentage": 85.0
}
}Response Body 스키마
| 필드명 | 타입 | 설명 |
|---|---|---|
success | boolean | 처리 성공 여부 |
updatedItemIds | array<long> | 업데이트된 항목 ID 목록 |
budgetWarning | boolean | 예산 80% 미달 경고 (true면 CREATOR_MATCHING 전환 보류) |
budgetUsagePercentage | double | 현재 예산 사용률 (%) |