https://dwtt.appDWTT로 다운로드 구축하기
DWTT는 익명 실행이 아닌 계획을 위한 이 통합 개요를 게시합니다. 지원팀은 범위가 지정된 키와 그 트래픽 허용량을 발급하기 전에 클립 워크플로우를 승인해야 합니다.
빠른 시작
DWTT는 API 호스트를 쉽게 스캔할 수 있게 합니다. 페이지는 지원 활성화 자격 증명으로 시작하여 할당된 테넌트 엔드포인트로 이동하며, 서버 전용 호출 경로를 명확히 명시합니다.
X-API-Key: pending_activation_…DwttToolkitv1# Available only after support activation
export DWTT_TOOL_TOKEN="issued-after-review"
curl -X POST https://dwtt.app/v1/resolve \
-H "X-API-Key: $DWTT_TOOL_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'DWTT는 서버 측 비밀 저장을 통해 자격 증명 안전을 접근하며, 클라이언트 번들 내장 없이 진행됩니다. 이 간소화된 작업 흐름은 공개 로그나 저장소를 명시적으로 남기지 않습니다.
링크 해결하기
DWTT는 Resolve 작업을 쉽게 스캔할 수 있게 합니다. 페이지는 소스 감지로 시작하여 제출된 하나의 URL에서 형식으로 이동하며, 발명된 출력물이 없음을 명확히 명시합니다.
/v1/resolve범위: 해결| 필드 | 종류 | 필수 | 설명 |
|---|---|---|---|
source_link | HTTPS URL | 네 | 분석할 공개 또는 승인된 미디어 페이지. |
tenant | 문자열 | 네 | 할당된 테넌트 도메인. 일반적으로 생략됩니다. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}DWTT은 반환된 값을 변경 없이 포맷 식별자로 접근한 후, 링크별 가용성을 확인합니다. 간소화된 작업 흐름은 추정된 품질 라벨을 명시하지 않습니다.
다운로드 작업 만들기 및 추적
DWTT에서는 작업 생성 설명 시 비동기 준비가 먼저 진행됩니다. 이 간소화된 작업 흐름은 짧은 HTTP 요청으로 이어지며 제한된 작업자 실행으로 종료됩니다.
/v1/jobs범위 : 일자리| 필드 | 종류 | 필수 | 설명 |
|---|---|---|---|
source_link | HTTPS URL | 네 | 해결하기 위해 제출한 동일한 정규화된 소스. |
format_ref | 문자열 | 네 | 해결 응답에서 정확한 ID. |
tenant | 문자열 | 네 | 할당된 테넌트 도메인. 일반적으로 생략됩니다. |
curl -X POST https://dwtt.app/v1/jobs \
-H "X-API-Key: $DWTT_TOOL_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID","format_ref":"18"}'task_ref.GET /v1/jobs/{task_ref} 같은 키로 열어야 합니다.| 상태 | 의미 | 클라이언트 동작 |
|---|---|---|
queued | 경계가 있는 대기열에 허용됨. | 백오프로 다시 폴링합니다. |
extracting | 소스 메타데이터 또는 경로를 새로 고침합니다. | 폴링을 계속합니다. |
processing | 다운로드, 리믹스 또는 병합. | 서버 진행 상황을 표시합니다. |
ready | 서명된 다운로드가 가능합니다. | URL을 사용자에게 보냅니다. |
failed | 터미널 구조화 오류. | 읽기 error_code. 권장되는 경우에만 다시 시도하십시오. |
expired | 임시 출력이 제거되었습니다. | 새 작업을 만듭니다. |
curl https://dwtt.app/v1/jobs/TASK_REF \
-H "X-API-Key: $DWTT_TOOL_TOKEN"작업 폴링을 설명하기 위해 DWTT는 1초 초기 대기와 제한된 백오프를 구분합니다. 간소화된 워크플로우는 임시 서명 전달에 별도의 위치를 제공합니다.
예측 가능한 오류
비 2xx 응답 하나가 DWTT의 오류 계약 시작점입니다. 간소화된 워크플로우는 지원 요청 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 | 대기열/용량 또는 업스트림을 일시적으로 사용할 수 없습니다. | 지수 백오프 및 지터로 다시 시도합니다. |
운영 계약
DWTT는 활성화 중에 트래픽 허용량을 설정하여 클립 통합 및 소스 네트워크가 과부하되지 않도록 합니다.
- idempotent 애플리케이션 로직을 사용하고 동일한 사용자 클릭에 대해 중복 작업을 시작하지 마십시오.
- 캐시는 메타데이터를 간략하게 해결하지만 서명된 다운로드 URL은 항상 만료된 것으로 취급합니다.
- 지터가 있는 한정된 지수 백오프를 사용하여
429,503그리고 재시도 가능한 오류들. - 공용 미디어 또는 액세스 권한이 있는 미디어만 처리합니다.DRM 및 액세스 제어가 우회되지 않습니다.
- 요청 ID와 작업 ID를 개인 운영 로그에 보관하십시오. 제출된 URL을 불필요하게 로그하지 마십시오.
DWTT는 스키마 접근을 쉽게 스캔할 수 있도록 합니다. 페이지는 탐색 전에 활성화로 시작하여 할당된 인증으로 이동하며, 문서화된 요청 형식을 명확하게 명시합니다.
지원을 통해 활성화
의도된 통합, 예상 요청량 및 대상 네트워크를 DWTT에 전송하세요. 클라이언트가 해상도, 작업 생성 또는 둘 다를 필요로 하는지 언급하여 범위가 지정된 키가 승인되고 표시될 수 있도록 하세요.
활성화 요청하기 키는 테넌트 범위가 있고 취소 가능하며 연락처 양식을 통해 발급됩니다.익명 스크립트는 다운로더 작업을 실행할 수 없습니다.