https://easyt.ioEasyT로 다운로드 생성
이 EasyT 참조는 활성 익명 엔드포인트가 아닌 구현 가이드입니다. 프로덕션 접근은 지원팀이 클라이언트를 승인하고 제한을 할당한 후에 시작됩니다.
빠른 시작
API 호스트는 EasyT에서 지원 활성화 자격 증명으로 시작합니다. 이 안내된 검사는 할당된 테넌트 엔드포인트를 제시합니다. 최종 사실은 서버 전용 호출 경로입니다.
X-API-Key: pending_activation_…EasytWorkspacev1# 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에서는 자격 증명 안전성을 설명할 때 서버 측 비밀 저장소가 우선입니다. 이 안내된 검사는 클라이언트 번들 포함이 없음을 따르며, 공개 로그나 저장소가 없음을 마무리합니다.
링크 해결하기
해결 작업은 EasyT에서 소스 감지로 시작됩니다. 이 안내된 검사는 제출된 URL 하나에서 형식을 제시합니다. 최종 사실은 발명된 출력물이 없다는 것입니다.
/v1/resolve범위: 해결| 필드 | 종류 | 필수 | 설명 |
|---|---|---|---|
input_url | HTTPS URL | 네 | 분석할 공개 또는 승인된 미디어 페이지. |
tenant | 문자열 | 네 | 할당된 테넌트 도메인. 일반적으로 생략됩니다. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}EasyT에서는 포맷 식별자를 설명할 때 반환된 값이 변경 없이 먼저 나옵니다. 그 안내 검사는 링크별 가용성을 따르고 추정 품질 라벨 없음으로 마무리됩니다.
다운로드 작업 만들기 및 추적
비동기 준비는 EasyT에서 작업 생성의 출발점입니다. 안내된 검사는 짧은 HTTP 요청을 제시하고 제한된 작업자 실행을 설명합니다.
/v1/jobs범위 : 일자리| 필드 | 종류 | 필수 | 설명 |
|---|---|---|---|
input_url | HTTPS 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"}'workspace_job.GET /v1/jobs/{workspace_job} 같은 키로 열어야 합니다.| 상태 | 의미 | 클라이언트 동작 |
|---|---|---|
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초의 초기 대기로 시작합니다. 이 가이드 체크는 이를 캡핑된 백오프와 페어링하고 임시 서명된 전달로 끝냅니다.
예측 가능한 오류
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 | 대기열/용량 또는 업스트림을 일시적으로 사용할 수 없습니다. | 지수 백오프 및 지터로 다시 시도합니다. |
운영 계약
EasyT는 검토 중에 운영 허용 오차를 선택하여 응용 프로그램의 요구 사항과 제공자 건강의 균형을 맞춥니다.
- idempotent 애플리케이션 로직을 사용하고 동일한 사용자 클릭에 대해 중복 작업을 시작하지 마십시오.
- 캐시는 메타데이터를 간략하게 해결하지만 서명된 다운로드 URL은 항상 만료된 것으로 취급합니다.
- 지터가 있는 한정된 지수 백오프를 사용하여
429,503그리고 재시도 가능한 오류들. - 공용 미디어 또는 액세스 권한이 있는 미디어만 처리합니다.DRM 및 액세스 제어가 우회되지 않습니다.
- 요청 ID와 작업 ID를 개인 운영 로그에 보관하십시오. 제출된 URL을 불필요하게 로그하지 마십시오.
스키마 접근은 EasyT에서 탐색 전에 활성화로 시작됩니다. 이 안내된 확인은 할당된 인증을 제시합니다. 최종 사실은 문서화된 요청 형태입니다.
지원을 통해 활성화
활성화 메모에 클라이언트 목적, 예상 월간 작업량 및 요청된 네트워크를 포함하세요. 그런 다음 EasyT는 하나의 뷰 비밀을 생성하기 전에 해결 및 작업 범위를 올바르게 선택할 수 있습니다.
활성화 요청하기 키는 테넌트 범위가 있고 취소 가능하며 연락처 양식을 통해 발급됩니다.익명 스크립트는 다운로더 작업을 실행할 수 없습니다.