미리보기 전용 — 활성화 필요

downf.io로 다운로드 생성하기

DownF는 운영자가 호환성 사용 사례를 검토할 때까지 API 실행을 비활성화 상태로 유지합니다. 예시는 계획된 계약을 설명하며, 실제 자격 증명과 할당량은 지원 활성화를 통해서만 제공됩니다.

DownfBridgeHTTPS를 통한 JSON비동기 작업범위가 지정된 자격 증명
01

빠른 시작

DownF는 지원 활성화 자격 증명을 중심으로 API 호스트를 구성합니다. 이 호환성 뷰는 할당된 테넌트 엔드포인트를 비교합니다. 서버 전용 호출 경로가 최종 확인으로 남아 있습니다.

임대자 URLhttps://downf.io
인증X-API-Key: pending_activation_…
클라이언트 프로필DownfBridge
API 버전v1
# Available only after support activation
export DOWNF_ACCESS_TOKEN="issued-after-review"

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

자격 증명 안전은 DownF에서 서버 측 비밀 저장으로 시작됩니다. 이 호환성 뷰는 클라이언트 번들 임베딩을 전혀 제공하지 않습니다. 최종 사실은 공개 로그나 저장소가 없다는 것입니다.

02

링크 해결하기

DownF는 소스 감지를 중심으로 Resolve 작업을 구성합니다. 호환성 보기는 제출된 URL 하나의 형식을 비교합니다. 발명된 출력이 없다는 것이 최종 확인입니다.

메시지/v1/resolve범위: 해결
필드종류필수설명
media_addressHTTPS URL분석할 공개 또는 승인된 미디어 페이지.
tenant문자열할당된 테넌트 도메인. 일반적으로 생략됩니다.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

포맷 식별자는 DownF에서 반환된 값을 변경 없이 시작합니다. 이 호환성 뷰는 링크별 가용성을 표시합니다. 최종 사실은 추측된 품질 레이블이 없다는 것입니다.

03

다운로드 작업 만들기 및 추적

작업 생성은 DownF에서 비동기 준비로 시작됩니다. 다음 뷰는 짧은 HTTP 요청을 다룹니다. 페이지는 보운드 워커 실행을 볼 수 있도록 유지합니다.

메시지/v1/jobs범위 : 일자리
필드종류필수설명
media_addressHTTPS URL해결하기 위해 제출한 동일한 정규화된 소스.
output_ref문자열해결 응답에서 정확한 ID.
tenant문자열할당된 테넌트 도메인. 일반적으로 생략됩니다.
curl -X POST https://downf.io/v1/jobs \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'
1202 승인됨저장 transfer_ref.
2투표 상태GET /v1/jobs/{transfer_ref} 같은 키로 열어야 합니다.
3준비서명된 다운로드 URL을 엽니다.
상태의미클라이언트 동작
queued경계가 있는 대기열에 허용됨.백오프로 다시 폴링합니다.
extracting소스 메타데이터 또는 경로를 새로 고침합니다.폴링을 계속합니다.
processing다운로드, 리믹스 또는 병합.서버 진행 상황을 표시합니다.
ready서명된 다운로드가 가능합니다.URL을 사용자에게 보냅니다.
failed터미널 구조화 오류.읽기 error_code. 권장되는 경우에만 다시 시도하십시오.
expired임시 출력이 제거되었습니다.새 작업을 만듭니다.
curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

DownF의 호환성 보기는 Job 폴링에 대한 1초 초기 대기를 검토합니다. 그것은 다음에 캡이 걸린 백오프를 보여주며 임시 서명된 전달을 흐리게하지 않습니다.

04

예측 가능한 오류

DownF는 오류 계약에 대해 세 가지 실용적인 포인트를 제시합니다. 첫 번째는 비 2xx 응답입니다. 호환성 화면에서는 지원 요청 ID를 다룹니다. 마지막 포인트는 예측 가능한 클라이언트 처리입니다.

{
  "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": "…"
}
HTTP전형적인 의미동작
400잘못된 URL, 본문 또는 사용할 수 없는 형식입니다.요청을 수정합니다. 형식에 대해 다시 해결합니다.
401누락, 잘못된, 만료 또는 잘못된 범위 키.서버 측 자격 증명을 확인합니다.
403테넌트 또는 소스 정책이 요청을 거부했습니다.정책을 우회하지 마십시오.지원에 문의하십시오.
404알 수 없거나 만료된 작업입니다.적절한 경우 새 작업을 만듭니다.
429요청 또는 활성 작업 제한에 도달했습니다.명예 retry_after_seconds.
503대기열/용량 또는 업스트림을 일시적으로 사용할 수 없습니다.지수 백오프 및 지터로 다시 시도합니다.
05

운영 계약

DownF는 의도된 클라이언트를 검토한 후 요청 천장을 할당하여 호환성 검사 및 업스트림 공급자를 안정적으로 유지합니다.

DownF는 탐색 전에 활성화를 중심으로 스키마 접근을 조직합니다. 호환성 뷰는 할당된 인증을 비교합니다. 문서화된 요청 형식은 최종 확인 단계로 남아 있습니다.

운영자 검토 액세스

지원을 통해 활성화

제품을 설명하고, 월별 통화량을 예측하며, 분석해야 할 플랫폼을 나열하세요. DownF 지원팀은 일회성 가시 자격 증명을 발급하기 전에 필요한 범위를 확인하며, 저장된 사본은 해시 값만 포함됩니다.

활성화 요청하기 키는 테넌트 범위가 있고 취소 가능하며 연락처 양식을 통해 발급됩니다.익명 스크립트는 다운로더 작업을 실행할 수 없습니다.