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

SaveTK로 다운로드 구축

SaveTK는 크리에이터 도구 통합을 위한 API 계획을 표시하지만, 인증되지 않은 실행은 허용하지 않습니다. 승인 시 키와 운영 한도를 모두 제공합니다.

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

빠른 시작

SaveTK는 API 호스트를 위한 세 가지 실용적인 포인트를 제시합니다. 첫 번째는 지원 활성화 자격 증명입니다. 저장 워크플로우는 할당된 테넌트 엔드포인트를 다룹니다. 마지막 포인트는 서버 전용 호출 경로입니다.

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

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

SaveTK는 자격 증명 안전을 쉽게 스캔할 수 있게 합니다. 페이지는 서버 측 비밀 저장으로 시작하여 클라이언트 번들 포함이 없으며, 공개 로그나 저장소가 없음을 명확히 밝힙니다.

02

링크 해결하기

SaveTK는 Resolve 작업을 위한 세 가지 실용적인 포인트를 제시합니다. 첫 번째는 소스 감지입니다. 저장 워크플로우는 제출된 하나의 URL에서 형식을 다룹니다. 마지막 포인트는 발명된 출력물이 없다는 것입니다.

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

SaveTK는 포맷 식별자를 쉽게 스캔할 수 있게 합니다. 페이지는 반환된 값을 변경 없이 시작하고, 링크별 가용성으로 이동하며, 추정된 품질 라벨이 없음을 명확히 표시합니다.

03

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

작업 생성은 SaveTK에서 비동기 준비로 시작됩니다. 이 저장 워크플로우는 짧은 HTTP 요청을 제공합니다. 최종 사실은 제한된 작업자 실행입니다.

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

SaveTK는 작업 폴링을 처리할 때 먼저 1초간 초기 대기 시간을 식별합니다. 이후 제한된 백오프를 따르며 임시 서명된 전달을 유지합니다.

04

예측 가능한 오류

오류 계약은 SaveTK에 하나의 비 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

운영 계약

SaveTK는 예상 트래픽과 범위 내 게시 플랫폼을 검토한 후 크리에이터 작업 흐름 허용량을 설정합니다.

SaveTK는 스키마 접근을 위한 세 가지 실용적인 포인트를 제시합니다. 첫 번째는 탐색 전에 활성화입니다. 저장 워크플로우는 할당된 인증을 다룹니다. 마지막 포인트는 문서화된 요청 형태입니다.

운영자 검토 액세스

지원을 통해 활성화

SaveTK 클라이언트가 수행하는 작업, 예상 호출 수 및 필수 게시 서비스가 무엇인지 명시하세요. 지원 검토는 범위를 선택한 후 한 번만 표시되는 복구 불가능한 자격 증명을 반환합니다.

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