API 변경 이력

API v5 대량 수집(bulk_jobs) 추가 — 최대 5,000개를 보내면 접수 번호를 바로 받음

POST /v5/api/collections/bulk_jobs에 collections/bulk와 같은 items를 최대 5,000개 보내면, 수집을 시작하기 전에 곧바로 202와 접수 번호를 돌려주고 처리는 그다음 차례로 진행합니다. 진행 상황과 항목별 결과(만들어진 데이터셋)는 GET /v5/api/collections/bulk_jobs/{job_id}로 봅니다. 항목 하나의 처리·크레딧은 collections/bulk와 같습니다. 기존 collections/bulk(최대 100개, 처리 뒤 응답)는 그대로입니다.

조치 — 따로 고칠 것은 없습니다. 100개를 넘게 보내거나 응답이 늦어 연결이 끊기던 연동이라면 대량 수집으로 옮기세요.

API v5 공개 — 봇·설정·주기·데이터셋

새 버전 /v5/api를 열었습니다. 화면과 같은 말(봇·설정·주기·데이터셋)로 자원을 나눴고, 한 봇에 주기를 여러 개 둘 수 있으며, 데이터셋에서 수집이 수동인지 어느 주기인지(trigger·plan)와 쓴 조건(inputs)을 읽을 수 있습니다. 수집 시작·주기 만들기·재수집은 Idempotency-Key 헤더(재시도 중복 방지 키)가 필수입니다. 같은 API 키를 씁니다.

웹훅 본문에는 기존 칸 뒤에 trigger·plan·inputs가 더해졌습니다(기존 칸·X-HashScraper-Version은 그대로).

V2·V3·V4 의 응답과 동작은 바뀌지 않았습니다.

조치 — 따로 고칠 것은 없습니다. v5 로 옮기려면 v4 → v5 옮기기를 보세요. 특히 save_to_settings 기본값이 v4 param_save(false)와 달리 true입니다.

이미 끝난 데이터셋의 취소 요청은 상태를 바꾸지 않음

완료(finish·complete)·취소 완료(canceled)·실패한 데이터셋에 취소를 요청하면(V4 schedule_results/:id/cancel, V2 cancel_collect) 응답은 지금처럼 성공이지만 상태는 바뀌지 않습니다. V4 응답의 sr_status에는 지금 상태가 그대로 돌아옵니다. 예전에는 canceling으로 덮였습니다.

조치 — 따로 고칠 것은 없습니다. 취소 응답의 sr_status가 항상 canceling이라고 가정한 코드라면, 이미 끝난 상태값이 올 수 있다는 점만 확인해 주세요.

데이터셋 상태 sr_status 에 canceled(취소 완료) 추가

취소를 요청하면 지금처럼 canceling(취소 진행 중)으로 바뀌고, 작업이 모두 정리되면 canceled로 바뀝니다. 예전에는 취소가 끝나도 canceling에 머물렀습니다.

기존에 canceling으로 남아 있던 데이터셋도 순차적으로 canceled로 정리됩니다. sr_status 조회 필터(V2 get_schedule_results, V4 schedule_results)에도 canceled를 쓸 수 있습니다.

조치 — sr_status 값으로 분기하는 코드가 있다면 canceled를 취소가 끝난 상태로 처리해 주세요. canceling을 기다리며 반복 조회하는 코드는 canceled가 오면 멈추면 됩니다. 알 수 없는 값을 오류로 처리하는 코드라면 canceled를 허용 목록에 더해 주세요.