YouTube videos and Shorts Open API 연동 가이드

TapSave Open API로 공개 YouTube videos and Shorts 링크를 분석하고 반환된 미디어 리소스를 애플리케이션에서 처리하는 방법을 알아보세요.

연동 흐름

https://api.videotool.cc/openapi/parse 로 POST 요청을 보냅니다. Content-Type: application/json, X-API-Key 헤더와 공개 링크가 들어 있는 JSON 본문의 url 필드를 사용합니다.

응답 처리

먼저 code === 200, data.resultCode === 0, data.hasResource === true 를 확인합니다. 그 후 해당 응답에서 실제로 반환된 리소스 배열만 처리하고 URL을 추측하거나 고정 형식을 가정하지 마세요.

YouTube videos and Shorts resources

For YouTube, audio can be in videoList[].audioUrl or audioList; do not promise audio or MP4 when those fields are empty.

제한 및 보안

API 키는 서버에 보관하고 브라우저 코드에 노출하지 마세요. 비공개, 삭제됨, 제한됨 또는 사용할 수 없는 링크는 예상 가능한 분석 실패로 처리해야 합니다.