YTSave로 다운로드 생성

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

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

자격 증명 안전성을 설명하기 위해, YTSave는 서버 측 비밀 저장소를 클라이언트 번들 내장과 분리합니다. 증거 기록은 공개 로그나 저장소에 별도의 위치를 부여하지 않습니다.

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

형식 식별자를 설명하기 위해, YTSave는 반환된 값을 링크별 가용성과 변경 없이 분리합니다. 증거 기록은 추측된 품질 레이블에 별도의 위치를 부여하지 않습니다.

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

curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSave는 Job 폴링을 쉽게 스캔할 수 있도록 합니다.페이지는 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을 불필요하게 로그하지 마십시오.

YTSave는 탐색 전에 먼저 활성화를 식별하여 스키마 접근을 처리합니다. 그 후 할당된 인증을 따르며 문서화된 요청 형식을 계속 확인합니다. OpenAPI 참조