URL로 파일 전달
파일 링크가 충족해야 하는 규칙과, 각 입력이 허용하는 콘텐츠 유형.
업로드 엔드포인트는 없습니다. 파일 입력은 공개 HTTPS 링크, 이를 가져와 검증한 뒤 실행이 시작되기 전에 여러분의 Morphic 프로젝트로 복사합니다. 여러분의 CDN은 자체 콘텐츠의 원본으로 유지되며, 이미지, 비디오, 오디오, 문서는 모두 하나의 계약을 사용합니다.
모든 링크는 다음을 모두 충족해야 합니다
| 요구 사항 | 세부 정보 |
|---|---|
| HTTPS | 일반 http 는 거부됩니다 |
| 파일을 제공해야 합니다 | 응답 본문은 바이트여야 합니다. 미리보기나 공유 페이지 — Drive 뷰어, Dropbox 랜딩 페이지, 그 어떤 HTML 래퍼도 — 는 거부됩니다 |
| 공개 호스트 이름 | 호스트 이름만 허용됩니다. IP 주소, localhost, 또는 비공개 주소로 해석되는 이름은 거부됩니다 |
| URL에 인증 정보 없음 | https://user:pass@… 는 거부됩니다. 사전 서명된 쿼리 문자열은 허용되며, 우리의 로그에 절대 기록되지 않습니다 |
| 목록에 있는 콘텐츠 유형 | 응답의 Content-Type 해당 입력의 것 중 하나여야 합니다 url_content_types |
| 일치하는 바이트 | 파일의 처음 바이트는 보관되기 전에, 제공된 형식과 대조하여 검사됩니다. PDF로 제공된 PNG, JSON으로 제공된 HTML 페이지, 또는 DOCX로 제공된 ZIP은 거부됩니다 |
내부에서 max_bytes | 다음 기준으로 검사됩니다 Content-Length 먼저, 그다음 바이트가 스트리밍되는 동안 다시 강제됩니다 |
| 최대 3회 리디렉션 | 3회 초과 홉은 거부됩니다 |
| 전체 가져오기 동안 유효함 | 전송 도중 만료되는 링크는 실행을 실패시킵니다 |
| 비어 있지 않음 | 0바이트를 제공하는 링크는 거부됩니다 |
| 신속하게 제공됨 | 약 40초 안에 전체 파일을 전달할 수 없는 호스트는 거부되며, 한 실행의 링크들은 합쳐서 약 90초가 주어집니다 |
수명이 짧은 서명된 링크가 파일이 절반만 가져와지는 일반적인 원인입니다. 실행을 시작한 시점 이후로도 최소 몇 분 이상은 유효하도록 하세요.
입력 유형별 콘텐츠 유형
입력에 대한 정확한 목록은 해당 입력의 url_content_types입니다. 이는 각 입력 유형이 허용하도록 구성할 수 있는 유형입니다.
| 입력 유형 | 콘텐츠 유형 |
|---|---|
이미지 | image/png, image/jpeg, image/webp, image/gif, image/tiff, image/avif, image/heic |
비디오 | video/mp4, video/webm, video/quicktime, video/mpeg, video/x-matroska |
오디오 | audio/mpeg, audio/wav, audio/aac, audio/ogg, audio/mp4, audio/webm |
문서 | application/pdf, text/plain, text/markdown, text/csv, application/json, 그리고 DOCX |
입력 목록에 없는 것은 무엇이든 거부됩니다. "모든 파일" 입력 유형은 없으며, 확장자는 절대 신뢰되지 않습니다 — 바이트가 무엇인지가 중요합니다.
실행당 한도
모든 파일 입력을 합쳐 실행당 링크와 바이트에는 한도가 있습니다 — 참조: 오류 및 한도.