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

EasyT로 다운로드 생성

이 EasyT 참조는 활성 익명 엔드포인트가 아닌 구현 가이드입니다. 프로덕션 접근은 지원팀이 클라이언트를 승인하고 제한을 할당한 후에 시작됩니다.

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

빠른 시작

API 호스트는 EasyT에서 지원 활성화 자격 증명으로 시작합니다. 이 안내된 검사는 할당된 테넌트 엔드포인트를 제시합니다. 최종 사실은 서버 전용 호출 경로입니다.

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

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

EasyT에서는 자격 증명 안전성을 설명할 때 서버 측 비밀 저장소가 우선입니다. 이 안내된 검사는 클라이언트 번들 포함이 없음을 따르며, 공개 로그나 저장소가 없음을 마무리합니다.

02

링크 해결하기

해결 작업은 EasyT에서 소스 감지로 시작됩니다. 이 안내된 검사는 제출된 URL 하나에서 형식을 제시합니다. 최종 사실은 발명된 출력물이 없다는 것입니다.

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

EasyT에서는 포맷 식별자를 설명할 때 반환된 값이 변경 없이 먼저 나옵니다. 그 안내 검사는 링크별 가용성을 따르고 추정 품질 라벨 없음으로 마무리됩니다.

03

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

비동기 준비는 EasyT에서 작업 생성의 출발점입니다. 안내된 검사는 짧은 HTTP 요청을 제시하고 제한된 작업자 실행을 설명합니다.

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

Job 폴링의 경우 EasyT는 1초의 초기 대기로 시작합니다. 이 가이드 체크는 이를 캡핑된 백오프와 페어링하고 임시 서명된 전달로 끝냅니다.

04

예측 가능한 오류

EasyT는 오류 계약을 쉽게 스캔할 수 있게 합니다. 페이지는 하나의 비-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

운영 계약

EasyT는 검토 중에 운영 허용 오차를 선택하여 응용 프로그램의 요구 사항과 제공자 건강의 균형을 맞춥니다.

스키마 접근은 EasyT에서 탐색 전에 활성화로 시작됩니다. 이 안내된 확인은 할당된 인증을 제시합니다. 최종 사실은 문서화된 요청 형태입니다.

운영자 검토 액세스

지원을 통해 활성화

활성화 메모에 클라이언트 목적, 예상 월간 작업량 및 요청된 네트워크를 포함하세요. 그런 다음 EasyT는 하나의 뷰 비밀을 생성하기 전에 해결 및 작업 범위를 올바르게 선택할 수 있습니다.

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