스크래퍼 설정 변경 V2

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

스크래퍼의 수집 파라미터·실행 주기·유니온 옵션을 변경합니다.

변경 결과는 응답의 settings로 확인할 수 있습니다.

param1~param5, period, union 중 요청에 포함되지 않은 항목은 기존 값을 그대로 유지합니다. 일부 필드만 갱신하고 싶을 때 이 점을 활용하세요.

이용권 기간이 만료되었거나 보유 크레딧이 부족하면 요청이 거부됩니다. 이 경우 응답 키는 message가 아닌 error_message로 내려옵니다.

요청 파라미터

  • api_key: String
    해시스크래퍼 API 키API키 확인하기
    예시 YOUR_API_KEY
  • schedule_id: String
    변경할 스크래퍼의 ID.
    예시 YOUR_SCHEDULE_ID
  • param1: optional String
    스크래퍼의 첫 번째 파라미터로 저장할 값. 생략하면 기존 값을 유지합니다.
  • param2: optional String
    스크래퍼의 두 번째 파라미터로 저장할 값. 동일한 규칙이 적용됩니다.
  • param3: optional String
    스크래퍼의 세 번째 파라미터로 저장할 값. 동일한 규칙이 적용됩니다.
  • param4: optional String
    스크래퍼의 네 번째 파라미터로 저장할 값. 동일한 규칙이 적용됩니다.
  • param5: optional String
    스크래퍼의 다섯 번째 파라미터로 저장할 값. 동일한 규칙이 적용됩니다.
  • period: optional String
    수집 주기. manual(수동), hour(매시간), day(매일) 중 하나. 생략하면 기존 값을 유지합니다.
    허용값 manual, hour, day
  • union: optional Boolean
    유니온 옵션. JSON Boolean(true/false)으로 보내야 하며, 문자열은 받지 않습니다.

응답 필드

  • result: String
    요청 처리 결과.
    허용값 success, error
  • version: String
    API 버전.
    예시 v2
  • settings: Object
    변경 후 적용된 설정값.
    • param1: String | null
      변경 후 param1.
    • param2: String | null
      변경 후 param2.
    • param3: String | null
      변경 후 param3.
    • param4: String | null
      변경 후 param4.
    • param5: String | null
      변경 후 param5.
    • period: String
      변경 후 수집 주기.
    • union: Boolean
      변경 후 유니온 옵션.
  • elapsed_time: Float
    응답 생성에 걸린 시간(초 단위 숫자).
    예시 0.0145

에러 응답

  • schedule_id missing
    필수 파라미터 schedule_id가 누락되었습니다.
    {
  "result": "error",
  "version": "v2",
  "message": "`schedule_id` parameter is required"
}
  • Schedule not found
    전달된 schedule_id로 스크래퍼를 찾을 수 없거나 접근 권한이 없습니다.
    {
  "result": "error",
  "version": "v2",
  "message": "schedule(id: YOUR_SCHEDULE_ID) not found"
}
  • Invalid union
    union 값이 Boolean이 아닙니다. true 또는 false로 보내세요.
    {
  "result": "error",
  "version": "v2",
  "message": "union이 Boolean이 아닙니다. union: ..."
}
  • Invalid period
    period 값이 manual, hour, day 중 하나가 아닙니다.
    {
  "result": "error",
  "version": "v2",
  "message": "period는 'manual, hour, day' 중에서 입력해 주세요. period: ..."
}
  • Service ticket expired
    이용권 기간이 만료되어 요청이 거부되었습니다. 응답 키는 error_message입니다.
    {
  "result": "error",
  "version": "v2",
  "error_message": "서비스 이용권의 기간이 만료되었습니다."
}
  • Credit exhausted
    보유 크레딧을 모두 소진하여 요청이 거부되었습니다. 응답 키는 error_message입니다.
    {
  "result": "error",
  "version": "v2",
  "error_message": "보유하신 크레딧을 모두 사용하셨습니다."
}

관련 가이드

요청 예시
  • cURL
  • Ruby
  • Python
  • NodeJS
  • PHP
  • Java
옵션 파라미터
응답 예시 200 
{
  "result": "success",
  "version": "v2",
  "settings": {
    "param1": "검색어",
    "param2": null,
    "param3": null,
    "param4": null,
    "param5": null,
    "period": "manual",
    "union": false
  },
  "elapsed_time": 0.0145
}