{"openapi":"3.0.3","info":{"title":"APICK 유튜브 썸네일 다운로드","version":"1.0.0","description":"공개 영상에서 제공하는 가장 큰 썸네일을 JPG 파일로 받습니다. 성공하면 응답 본문이 이미지 파일 자체입니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/youtube_thumbnail":{"post":{"summary":"유튜브 썸네일 다운로드","description":"공개 영상에서 제공하는 가장 큰 썸네일을 JPG 파일로 받습니다. 성공하면 응답 본문이 이미지 파일 자체입니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"파일 직접 응답","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"조회할 유튜브 영상의 URL 또는 11자리 ID입니다. 예: https://youtu.be/dQw4w9WgXcQ 또는 dQw4w9WgXcQ. 재생목록·채널 URL은 영상 조회에 쓸 수 없습니다. (string)","example":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}},"required":["url"]}}}}}}},"x-code-tables":[{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["입력 오류","400","입력 항목이 잘못됐습니다. 유튜브 영상 주소 또는 11자리 영상 ID를 입력해 주세요.","영상 주소 형식이나 11자리 ID를 확인합니다."],["영상 없음","404","영상을 찾을 수 없습니다. 삭제·비공개 영상이거나 잘못된 주소입니다.","주소와 공개 여부를 확인합니다. 여러 영상을 차례로 받는 중이면 이 ID는 건너뜁니다."],["썸네일 없음","404","영상의 썸네일을 찾을 수 없습니다.","썸네일을 제공하지 않는 영상입니다. 영상 정보 조회의 thumbnails[]를 확인합니다."],["연령 제한","403","연령 제한 영상은 조회할 수 없습니다.","연령 제한 영상은 제공하지 않습니다."],["회원 전용","403","채널 회원 전용 영상은 조회할 수 없습니다.","채널 회원 전용 영상은 제공하지 않습니다."],["시간 초과","408","처리 시간 초과로 실패했습니다. 잠시 후 다시 시도해 주세요.","잠시 후 같은 요청을 다시 보냅니다."],["일시적 조회 실패","424","일시적으로 영상 정보를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.","잠시 후 같은 요청을 다시 보냅니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}