QuickDL로 다운로드 빌드

# Available only after support activation
export QUICKDL_JOB_KEY="issued-after-review"

curl -X POST https://quickdl.app/v1/resolve \
  -H "X-API-Key: $QUICKDL_JOB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'

QuickDL는 자격 증명 안전을 서버 측 비밀 저장소 식별로 먼저 처리합니다. 클라이언트 번들 포함이 없으며 공개 로그나 저장소를 보관하지 않습니다.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

QuickDL는 반환된 값을 변경 없이 먼저 식별하여 포맷 식별자를 처리합니다. 이어서 링크별 가용성을 확인하며 추정 품질 라벨을 표시하지 않습니다.

curl -X POST https://quickdl.app/v1/jobs \
  -H "X-API-Key: $QUICKDL_JOB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID","download_option":"18"}'

curl https://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

QuickDL는 작업 폴링을 위한 세 가지 실용적인 포인트를 제시합니다. 첫 번째는 1초의 초기 대기입니다. 이 간결한 유틸리티는 제한된 백오프를 다룹니다. 마지막 포인트는 임시 서명된 전달입니다.

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}

• idempotent 애플리케이션 로직을 사용하고 동일한 사용자 클릭에 대해 중복 작업을 시작하지 마십시오.
• 캐시는 메타데이터를 간략하게 해결하지만 서명된 다운로드 URL은 항상 만료된 것으로 취급합니다.
• 지터가 있는 한정된 지수 백오프를 사용하여 429, 503 그리고 재시도 가능한 오류들.
• 공용 미디어 또는 액세스 권한이 있는 미디어만 처리합니다. DRM 및 액세스 제어가 우회되지 않습니다.
• 요청 ID와 작업 ID를 개인 운영 로그에 보관하십시오. 제출된 URL을 불필요하게 로그하지 마십시오.

QuickDL에서는 스키마 접근을 설명할 때 탐색 전에 활성화가 먼저 나옵니다. 그 간결한 유틸리티는 할당된 인증을 따르고 문서화된 요청 형식으로 마무리됩니다.