재수집 요청 V2

POST api.hashscraper.com/api/retry_collect Content-Type: application/json; version=2

기존 데이터셋을 같은 ID로 재수집합니다.

이미 만들어진 데이터셋을 새 데이터셋으로 만들지 않고 같은 schedule_result_id로 다시 수집합니다. 데이터셋의 파라미터(스냅샷)와 결과 컬럼 설정은 처음 수집 시점 그대로 유지되며, 기존에 쌓인 결과는 그대로 유지된 채 이번 재수집으로 얻은 결과가 같은 데이터셋에 추가됩니다.

재수집은 새 수집 작업을 큐에 추가하므로 collect와 동일하게 이용권/크레딧 검사를 거칩니다. 이용권 기간이 만료되었거나 보유 크레딧이 부족하면 요청이 거부되며, 이 경우 응답 키는 error_message로 내려옵니다.

요청 후 진행 상태는 collect_status에서 같은 schedule_result_id로 확인할 수 있습니다.

요청 파라미터

api_key: String

해시스크래퍼 API 키API키 확인하기

예시 YOUR_API_KEY
schedule_result_id: Integer

재수집할 데이터셋 ID. 보통 collect 응답으로 받은 값을 그대로 전달합니다.

예시 YOUR_SCHEDULE_RESULT_ID

응답 필드

result: String

요청 처리 결과.

허용값 success, error
version: String

API 버전.

예시 v2
retry_info: Object
재수집 요청 결과 정보.
- schedule_result_id: Integer
  
  재수집된 데이터셋 ID. 요청 시 전달한 값과 동일합니다.
- schedule_id: String
  
  이 데이터셋이 속한 스크래퍼의 식별자. collect와 달리 요청값을 그대로 echo하지 않고, 서버에 저장된 값을 반환합니다.
- param_info: Object
  
  이 데이터셋이 처음 수집된 시점의 파라미터 스냅샷. 사용으로 지정된 param1~param5만 포함되며, 키 이름에 라벨이 함께 표기됩니다 (예: param1(검색어)). 스크래퍼에 라벨이 설정되지 않았으면 param1() 또는 param1(param1)처럼 라벨 자리가 비거나 placeholder로 남을 수 있습니다.
elapsed_time: Float

응답 생성에 걸린 시간(초 단위 숫자).

예시 0.4521

에러 응답

schedule_result_id missing

필수 파라미터 schedule_result_id가 누락되었습니다.

{
  "result": "error",
  "version": "v2",
  "message": "`schedule_result_id` parameter is required"
}

Schedule result not found

전달된 schedule_result_id로 데이터셋을 찾을 수 없거나 접근 권한이 없습니다.
```
{
  "result": "error",
  "version": "v2",
  "message": "schedule_result(id: YOUR_SCHEDULE_RESULT_ID) not found"
}
```
Service ticket expired

이용권 기간이 만료되어 재수집 요청이 거부되었습니다. 응답 키는 error_message입니다.
```
{
  "result": "error",
  "version": "v2",
  "error_message": "서비스 이용권의 기간이 만료되었습니다."
}
```
Credit exhausted

보유 크레딧을 모두 소진하여 재수집 요청이 거부되었습니다. 응답 키는 error_message입니다.
```
{
  "result": "error",
  "version": "v2",
  "error_message": "보유하신 크레딧을 모두 사용하셨습니다."
}
```
Retry blocked

이용권/크레딧 상태로 인해 재수집을 시작할 수 없습니다. 메시지에 사유가 함께 표시되며, 가능한 사유는 No active service ticket, Credit exhausted, Service ticket expired, Invalid service ticket입니다.
```
{
  "result": "error",
  "version": "v2",
  "message": "Retry blocked: ..."
}
```

요청 파라미터

응답 필드

에러 응답

관련 가이드