නිෂ්පාදන REST API · v1

YTSave සමඟ ගොනු බාගත කරන්න

පොදු මාධ්‍ය URL එකක් විසඳන්න, නිවැරදි ආකෘතියක් තෝරන්න, අසමකාලීන රැකියාවක් නිර්මාණය කරන්න සහ අත්සන් කළ ප්‍රතිඵලය ඔබේ පරිශීලකයාට ලබා දෙන්න. එම සීමාසහිත නිෂ්පාදන නළය YTSave වෙබ් අඩවියට බලය සපයයි.

YTSaveClientHTTPS මත JSONඅසමකාලීන රැකියාපරාසගත සහතික
01

ඉක්මන් ආරම්භය

YTSave පළමුව සහයෝගිතාව සක්‍රීය කළ අක්තපත්‍ර හඳුනාගෙන API සත්කාරකය කළමනාකරණය කරයි. එය පසුව පවරා ඇති කුලීකරු අවසානයක් අනුගමනය කරමින් සේවාදායක-මात्र ඇමතුම් මාර්ගයක් දෘශ්‍යමාන කරයි.

භාණ්ඩාගාරික URLhttps://ytsave.app
සත්‍යාපනයX-API-Key: ys_live_…
පාරිභෝගික පැතිකඩYTSaveClient
API අනුවාදයv1
# Available only after support activation
export YTSAVE_API_KEY="issued-after-review"

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

සහතික ආරක්ෂාව පැහැදිලි කිරීමට, YTSave සේවාදායක පාර්ශ්ව රහස් ගබඩා කිරීම සහ ගනුදෙනුකරු පැකේජය ඇතුළත් නොකිරීම වෙන් කරයි. සාක්ෂි වාර්තාවක් පොදු ලොග් හෝ ගබඩා ස්ථාන සඳහා ස්ථානයක් ලබා නොදේ.

02

සබැඳිය විසඳන්න

YTSave විසඳුම් මෙහෙයුම කළමනාකරණය කරන්නේ පළමුව මූලාශ්‍ර හඳුනා ගැනීම හඳුනාගෙනය. එය එක් ඉදිරිපත් කළ URL එකක සිට ආකෘති අනුගමනය කරයි සහ දෘශ්‍යයේ නිර්මාණය කළ ප්‍රතිදාන කිසිවක් තබන්නේ නැත.

POST/v1/resolveපරාසය: විසඳන්න
ක්ෂේත්‍රයවර්ගයඅවශ්‍යවිස්තරය
urlHTTPS URLඔව්විශ්ලේෂණය සඳහා මහජන හෝ අනුමත මාධ්‍ය පිටුවක්.
tenantස්ට්‍රිංනැතපවරා ඇති කුලීකරුවන්ගේ ඩොමේනය. සාමාන්‍යයෙන් අතහැර දමයි.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

ආකෘති හැඳුනුම්පත පැහැදිලි කිරීමට, YTSave සම්බන්ධතා-අවශ්‍යතාවයෙන් වෙනස් නොවූ ආපසු ලැබුණු අගය වෙන් කරයි. සාක්ෂි වාර්තාවක් කිසිදු අනුමානිත ගුණාත්මක ලේබලයක් සඳහා ස්ථානයක් ලබා නොදේ.

03

බාගත කිරීමේ කාර්යයක් නිර්මාණය කර අනුගමනය කරන්න

රැකියා නිර්මාණය සඳහා, YTSave අසමකාලීන සූදානමෙන් ආරම්භ කරයි. එහි සාක්ෂි වාර්තාව කෙටි HTTP ඉල්ලීමක් සමඟ ඒකරාශී කරයි සහ සීමාසහිත කාර්ය මණ්ඩල ක්‍රියාත්මක කිරීමෙන් අවසන් කරයි.

POST/v1/jobsපරාසය: රැකියා
ක්ෂේත්‍රයවර්ගයඅවශ්‍යවිස්තරය
urlHTTPS URLඔව්විසඳීමට ඉදිරිපත් කළ එකම සාමාන්‍යීකෘත මූලාශ්‍රය.
format_idස්ට්‍රිංඔව්විසඳුම් ප්‍රතිචාරයෙන් නිවැරදි හැඳුනුම් අංකයක්.
tenantස්ට්‍රිංනැතපවරා ඇති කුලීකරුවන්ගේ ඩොමේනය. සාමාන්‍යයෙන් අතහැර දමයි.
curl -X POST https://ytsave.app/v1/jobs \
  -H "X-API-Key: $YTSAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID","format_id":"18"}'
1202 පිළිගත්සුරකින්න job_id.
2සමීක්ෂණ තත්ත්වයGET /v1/jobs/{job_id} එම යතුර සමඟ.
3සූදානම්අත්සන් කළ බාගත කිරීමේ URL විවෘත කරන්න.
තත්ත්වයඅර්ථයපාරිභෝගික ක්‍රියාව
queuedසීමාසහිත පෝරමයට පිවිස ඇත.ආපසු යාම සමඟ නැවත මත පරීක්ෂණය කරන්න.
extractingමූලාශ්‍ර මැටාදත්ත හෝ මාර්ගය යළි පිරික්සමින්.පොලිං දිගටම කරගන්න.
processingබාගත කිරීම, නැවත මාරු කිරීම හෝ ඒකාබද්ධ කිරීම.සේවාදායක ප්‍රගතිය පෙන්වන්න.
readyඅත්සන් කළ බාගත කිරීම ලබා ගත හැක.URL පරිශීලකයාට යවන්න.
failedටර්මිනල් ව්‍යුහගත දෝෂයක්.පොඩින්න error_code. උපදෙස් දුන් විට පමණක් නැවත උත්සාහ කරන්න.
expiredතාවකාලික ප්‍රතිදානය ඉවත් කරන ලදී.නව රැකියාවක් සාදන්න.
curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSave රැකියා පරීක්ෂාව පහසු කරයි. පිටුව තත්පර 1ක ආරම්භක බලාපොරොත්තුවකින් ආරම්භ වෙයි, සීමාසහිත ප්‍රතික්ෂේපයට යයි, සහ තාවකාලික අත්සන් කළ බෙදාහැරීම පැහැදිලිව සඳහන් කරයි.

04

පූර්ව අනාවැකි දෝෂ

දෝෂ ගිවිසුම සඳහා, YTSave සහාය ඉල්ලීමේ හැඳුනුම්පතකට පෙර නො-2xx ලිපිගොනුවක් පරීක්ෂා කරයි. මෙම සාක්ෂි වාර්තාව පාරිභෝගික කළමනාකරණය පැහැදිලිව පෙන්වයි.

{
  "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

මෙහෙයුම් ගිවිසුම

YTSave API පරිභෝජකයා සහ ඉහළ මට්ටමේ මාධ්‍ය සේවාවන් ආරක්ෂා කිරීම සඳහා සෑම අනුමත කිරීමකටත් මෙහෙයුම් කොටසක් නිකුත් කරයි.

YTSave යොදා ගන්නේ සක්‍රීය කිරීම හඳුනා ගැනීමෙන් පසුව Schema ප්‍රවේශයයි. එය පසුව පවරා ඇති සත්‍යාපනය අනුගමනය කරමින් ලේඛිත ඉල්ලීම් ආකෘති දර්ශනයේ තබයි. OpenAPI යොමුපත

මෙහෙයුම්කරු-සමාලෝචනය කළ ප්‍රවේශය

ඔබගේ API යතුර ඉල්ලන්න

API පරිභෝජකයා, එහි මාසික ඉල්ලීම් අනුමානය සහ සහාය දක්වන වේදිකා අවශ්‍යතා ලේඛනය කරන්න. YTSave විසින් විසඳුම, රැකියා ඉදිරිපත් කිරීම හෝ දෙකම සාධාරණද යන්න සමාලෝචනය කර, එක් වතාවක් පෙනෙන යතුර නිකුත් කරයි.

API ප්‍රවේශය ඉල්ලන්න යතුරු කුලීකරුවන්ට සීමා කර ඇති අතර, අහඹු ලෙස අවලංගු කළ හැකි අතර සම්බන්ධතා පෝරමය හරහා නිකුත් කර ඇත. අනන්‍ය ලිපිනයන් බාගත කිරීමේ වැඩසටහන් ක්‍රියාත්මක කළ නොහැක.