Fetch Resource
최신 업데이트：2025-08-18 15:32:33
이 인터페이스는 지정한 URL에서 리소스를 가져와 지정한 공간(버킷)에 저장하는 기능을 제공합니다.
요청 설명
POST /fmgr/fetch
HOST: <MgrDomain>
Authorization:<accessToken>
헤더 설명
| 파라미터 | 필수 여부 | 설명 |
|---|---|---|
| HOST | 예 | 관리 도메인 이름, 콘솔의 버킷 개요에서 확인 가능 |
| Authorization | 예 | 관리 인증 정보 |
파라미터 설명
요청 파라미터는 다음 형식에 따라 요청 본문(Request Content)으로 제출합니다.
fops=fetchURL/<Urlsafe_Base64_Encoded_URL>/bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>/prefix/<Urlsafe_Base64_Encoded_prefix>/md5/<md5>/decompression/<decompression>/fetchTS/<fetchTS>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&force=<Force>&separate=<Separate>
| 파라미터 | 필수 여부 | 설명 |
|---|---|---|
| fops | 예 | 처리 파라미터 목록, 위의 형식대로 작성. 동시에 여러 처리를 요청할 수 있으며, 각 파라미터 목록은 ;로 구분 |
| fetchURL | 예 | 크롤링할 URL. <Urlsafe_Base64_Encoded_URL>은 지정한 URL의 URL-safe Base64 인코딩 문자열 |
| bucket | 예 | 대상 버킷 지정. <Urlsafe_Base64_Encoded_bucket>는 버킷명을 URL-safe Base64로 인코딩 |
| key | 아니오 | 리소스 저장 시 사용할 key(파일명) 지정. <Urlsafe_Base64_Encoded_key>는 파일명의 URL-safe Base64 인코딩 값. 미지정 시 파일명은 fetchURL의 URI가 사용됨 |
| prefix | 아니오 | 리소스 key(파일명) 앞에 붙는 접두어 지정. <Urlsafe_Base64_Encoded_prefix>는 접두어의 URL-safe Base64 인코딩 값. prefix 지정 시, 자원은 prefix/key로 저장됨 |
| md5 | 아니오 | 리소스의 md5 값 지정. 해당 URL에서 가져온 리소스의 md5가 일치할 때만 저장, 지정하지 않으면 md5 체크 없이 저장 |
| decompression | 아니오 | 지정한 타입의 파일을 압축 해제. zip/tar/gzip 지원. 예: /decompression/zip 설정 시 파일을 압축 해제 |
| fetchTS | 아니오 | m3u8 파일 크롤링 시 TS 파일도 함께 가져올지 지정: 0-TS 파일 크롤링 안함 1-TS 파일 크롤링함 미지정 시 기본 0, m3u8만 지원, TS 경로는 상대경로여야 하며 멀티비트레이트 m3u8 미지원 |
| notifyURL | 아니오 | 처리 결과 알림을 받을 URL. 알림 형식은 작업 조회 인터페이스 반환 형식과 동일 |
| force | 아니오 | 강제 처리 여부 1: 강제 처리 및 기존 결과 덮어쓰기 0: 기존 처리 결과 있으면 성공으로 간주, 중복 처리를 피함(기본 0) |
| separate | 아니오 | 처리 결과 알림 방식 선택. 1: 각 명령 실행 후 notifyURL로 개별 알림 0: 모든 명령 실행 후 한 번만 notifyURL로 알림(기본 0) |
요청 파라미터 예시
fops=fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuanBn/bucket/bXlidWNrZXQ=;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuanBn/bucket/bXlidWNrZXQ=/key/ZGlyL2FhLmpwZw==/prefix/YWFkaXIv/md5/0bee89b07a248e27c83fc3d5951213c1;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuemlw/bucket/bXlidWNrZXQ=/decompress/zip;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEubTN1OA==/bucket/bXlidWNrZXQ=/fetchTS/1¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&force=1&separate=1
응답 설명
- 요청에 성공하면, 아래와 같은 형태의
JSON문자열이 반환됩니다.
{ "persistentId": <persistentId> }
| 필드명 | 필수 여부 | 설명 |
|---|---|---|
| persistentId | 예 | 작업 처리 ID. 작업 진행상황 조회에 사용 가능 |
- 요청 실패 시, 아래와 같은 형태의
Json문자열이 반환됩니다.
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| 필드명 | 필수 여부 | 설명 |
|---|---|---|
| code | 예 | HTTP 요청 응답 코드, HTTP 응답 상태코드 참고 |
| message | 예 | 요청 실패 메시지 |
예시
curl -v -X POST -d "fops=fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuanBn/bucket/bXlidWNrZXQ=/key/ZGlyL2FhLmpwZw==/prefix/YWFkaXIv/md5/0bee89b07a248e27c83fc3d5951213c1;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuemlw/bucket/bXlidWNrZXQ=/decompress/zip¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&force=1&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/fetch"
이 문서의 내용이 도움이 되었습니까?
예
아니오