API 명세서 | Notion

이미지 처리 작업(Image Job)을 생성하고 상태를 조회할 수 있는 API입니다.

1. 기본 정보

Base URL: /api/v1/imageJobs
Content-Type: application/json

2. API 목록

🟢 이미지 처리 요청 (Process Image)

새로운 이미지 처리 작업을 등록합니다.

Endpoint: POST /api/v1/imageJobs/process
Description: 원본 이미지 URL을 전달하여 이미지 처리를 시작합니다.

Request Body

필드명	타입	필수 여부	설명
`sourceImageUrl`	`String`	필수	처리할 원본 이미지의 URL

Response Body (200 OK)

필드명	타입	설명
`imageJobId`	`Long`	작업 식별자
`sourceImageUrl`	`String`	원본 이미지 URL
`status`	`String`	작업 상태 (`PENDING`, `PROCESSING`, `DONE`, `FAILED` 등)
`resultImageUrl`	`String`	(Worker 작업 성공 시) 결과 이미지 URL
`resultAt`	`DateTime`	(Worker 작업 성공 시) 완료 일시
`failureCode`	`Integer`	(Worker 작업 실패 시) 에러 코드
`failureMessage`	`String`	(Worker 작업 실패 시) 에러 메시지
`failedAt`	`DateTime`	(Worker 작업 실패 시) 실패 일시
`createdAt`	`DateTime`	생성 일시
`updatedAt`	`DateTime`	최종 수정 일시

🔵 이미지 작업 단건 조회 (Read One)

특정 이미지 작업의 상세 정보와 결과 상태를 조회합니다.

Endpoint: GET /api/v1/imageJobs/{id}
Description: id에 해당하는 작업의 현재 상태, 결과 이미지 URL 또는 실패 정보를 반환합니다.

Path Variables