엑셀 파라미터 업로드 V2

POST api.hashscraper.com/api/set_excel_param Content-Type: multipart/form-data

엑셀 파일을 업로드해 스크래퍼의 파라미터 셋으로 등록합니다.

이 엔드포인트는 JSON이 아닌 multipart/form-data로 호출합니다. excel_file 필드에 .xlsx 파일을 첨부하면 해당 파일이 스크래퍼의 활성 파라미터 셋으로 등록됩니다.

업로드가 성공하면 같은 스크래퍼에 등록되어 있던 기존 파라미터 셋들은 모두 비활성화되고, 이번에 업로드한 파일 하나만 활성 상태로 남습니다.

요청 파라미터

  • api_key: String
    해시스크래퍼 API 키API키 확인하기
    예시 YOUR_API_KEY
  • schedule_id: String
    엑셀 파라미터를 등록할 스크래퍼의 ID.
    예시 YOUR_SCHEDULE_ID
  • excel_file: File
    .xlsx 파일. multipart/form-data 필드로 전송하며, MIME 타입은 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet로 지정합니다.

응답 필드

  • result: String
    요청 처리 결과.
    허용값 success, error
  • version: String
    API 버전.
    예시 v2
  • schedule_id: String
    엑셀 파라미터를 등록한 스크래퍼의 식별자.
  • file_name: String
    업로드된 엑셀 파일의 원본 파일명.
  • message: String
    성공 안내 메시지. 항상 Excel Parameter saved successfully가 반환됩니다.
  • elapsed_time: Float
    응답 생성에 걸린 시간(초 단위 숫자).
    예시 0.0512

에러 응답

  • schedule_id missing
    필수 파라미터 schedule_id가 누락되었습니다.
    {
  "result": "error",
  "version": "v2",
  "message": "`schedule_id` parameter is required"
}
  • excel_file missing
    필수 파라미터 excel_file이 누락되었습니다.
    {
  "result": "error",
  "version": "v2",
  "message": "`excel_file` parameter is required"
}
  • Schedule not found
    전달된 schedule_id로 스크래퍼를 찾을 수 없거나 접근 권한이 없습니다.
    {
  "result": "error",
  "version": "v2",
  "message": "schedule(id: YOUR_SCHEDULE_ID) not found"
}
  • Invalid file extension
    파일 확장자가 .xlsx 또는 .xls가 아닙니다.
    {
  "result": "error",
  "version": "v2",
  "message": "xlsx 또는 xls 형식의 파일을 선택해주세요"
}
  • Invalid content type
    excel_file의 MIME 타입이 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet가 아닙니다.
    {
  "result": "error",
  "version": "v2",
  "message": "\"excel_file\"의 type을 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet로 설정해주세요. ..."
}

관련 가이드

요청 예시 
curl -X POST \
  -F "api_key=YOUR_API_KEY" \
  -F "schedule_id=YOUR_SCHEDULE_ID" \
  -F "excel_file=@/path/to/file.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
  'api.hashscraper.com/api/set_excel_param'
응답 예시 200 
{
  "result": "success",
  "version": "v2",
  "schedule_id": "사람인_채용공고_수집_1697441449957",
  "file_name": "params.xlsx",
  "message": "Excel Parameter saved successfully",
  "elapsed_time": 0.0512
}