පෙරදසුන පමණි — සක්‍රීය කිරීම අවශ්‍යයි

QuickDL සමඟ බාගත කිරීම් ගොඩනගන්න

QuickDL සංවර්ධකයින්ට සක්‍රීය කිරීමට පෙර සංකුචිත ඉල්ලීම් ආදර්ශය පරීක්ෂා කිරීමට ඉඩ දෙයි. පෞද්ගලික යතුරක් සහ කොටසක් භාවිතා කිරීමට පෙර නිෂ්පාදනය වලංගු කර තිබිය යුතුය.

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

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

QuickDL හි, සහාය සක්‍රීය කළ හැඳුනුම්පත් API සත්කාරකය පැහැදිලි කිරීමේදී පළමුව වේ. එම සංකීර්ණ උපකරණය පසුව පවරා ඇති කුලීන් අවසන් ලිපිනය සමඟ අනුගමනය කරමින් සේවාදායක-පමණි ඇමතුම් මාර්ගයකින් අවසන් කරයි.

භාණ්ඩාගාරික URLhttps://quickdl.app

සත්‍යාපනයX-API-Key: pending_activation_…

පාරිභෝගික පැතිකඩQuickDlJobs

API අනුවාදයv1

# Available only after support activation
export QUICKDL_JOB_KEY="issued-after-review"

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

QuickDL සේවාදායක පාර්ශ්ව රහස් ගබඩා කිරීම ප්‍රථම හඳුනා ගැනීමෙන් සහතික ආරක්ෂාව කළමනාකරණය කරයි. එය පාරිභෝගික බන්ඩල් ඇතුළත් කිරීමක් නොකරයි සහ පොදු ලොග් හෝ ගබඩා දර්ශනය නොකරයි.

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

QuickDL හි, Resolve මෙහෙයුම පැහැදිලි කිරීමේදී මූලාශ්‍ර හඳුනා ගැනීම ප්‍රථම වේ. එම සංකීර්ණ උපකරණය එක් URL එකකින් ඉදිරිපත් කරන ලද ආකෘති සමඟ අනුගමනය කරයි සහ නිර්මාණය නොකළ ප්‍රතිදාන මත අවසන් වේ.

POST/v1/resolveපරාසය: විසඳන්න

ක්ෂේත්‍රය	වර්ගය	අවශ්‍ය	විස්තරය
`public_link`	HTTPS URL	ඔව්	විශ්ලේෂණය සඳහා මහජන හෝ අනුමත මාධ්‍ය පිටුවක්.
`tenant`	ස්ට්‍රිං	නැත	පවරා ඇති කුලීකරුවන්ගේ ඩොමේනය. සාමාන්‍යයෙන් අතහැර දමයි.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

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

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

QuickDL හි සංකුචිත උපකරණය රැකියා නිර්මාණය සඳහා අසමකාලීන සූදානම සමාලෝචනය කරයි. එය ඉදිරිපස කෙටි HTTP ඉල්ලීමක් පෙන්වයි සහ සීමාසහිත කාර්ය මණ්ඩල ක්‍රියාත්මක කිරීම මැවීමෙන් වැළකී සිටී.

POST/v1/jobsපරාසය: රැකියා

ක්ෂේත්‍රය	වර්ගය	අවශ්‍ය	විස්තරය
`public_link`	HTTPS URL	ඔව්	විසඳීමට ඉදිරිපත් කළ එකම සාමාන්‍යීකෘත මූලාශ්‍රය.
`download_option`	ස්ට්‍රිං	ඔව්	විසඳුම් ප්‍රතිචාරයෙන් නිවැරදි හැඳුනුම් අංකයක්.
`tenant`	ස්ට්‍රිං	නැත	පවරා ඇති කුලීකරුවන්ගේ ඩොමේනය. සාමාන්‍යයෙන් අතහැර දමයි.

curl -X POST https://quickdl.app/v1/jobs \
  -H "X-API-Key: $QUICKDL_JOB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID","download_option":"18"}'

1202 පිළිගත්සුරකින්න quick_job.

2සමීක්ෂණ තත්ත්වයGET /v1/jobs/{quick_job} එම යතුර සමඟ.

3සූදානම්අත්සන් කළ බාගත කිරීමේ URL විවෘත කරන්න.

තත්ත්වය	අර්ථය	පාරිභෝගික ක්‍රියාව
`queued`	සීමාසහිත පෝරමයට පිවිස ඇත.	ආපසු යාම සමඟ නැවත මත පරීක්ෂණය කරන්න.
`extracting`	මූලාශ්‍ර මැටාදත්ත හෝ මාර්ගය යළි පිරික්සමින්.	පොලිං දිගටම කරගන්න.
`processing`	බාගත කිරීම, නැවත මාරු කිරීම හෝ ඒකාබද්ධ කිරීම.	සේවාදායක ප්‍රගතිය පෙන්වන්න.
`ready`	අත්සන් කළ බාගත කිරීම ලබා ගත හැක.	URL පරිශීලකයාට යවන්න.
`failed`	ටර්මිනල් ව්‍යුහගත දෝෂයක්.	පොඩින්න `error_code`. උපදෙස් දුන් විට පමණක් නැවත උත්සාහ කරන්න.
`expired`	තාවකාලික ප්‍රතිදානය ඉවත් කරන ලදී.	නව රැකියාවක් සාදන්න.

curl https://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

QuickDL රැකියා පෝලිං සඳහා ප්‍රායෝගික ලක්ෂණ තුනක් ඉදිරිපත් කරයි. පළමුව තත්පර 1ක ආරම්භක බලා සිටීමක් ඇත. කුඩා උපකරණය පසුව සීමා කළ පසුබැසීම ආවරණය කරයි. එහි අවසන් ලක්ෂණය තාවකාලික අත්සන් කළ බෙදාහැරීමයි.

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

QuickDL එකක් නොවන 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	පෝරමය/සමර්ථතාව හෝ ඉහළ ගමන් මාර්ගය තාවකාලිකව ලබා ගත නොහැක.	ආරෝහණීය ප්‍රතික්ෂේප සහ කම්පනය සමඟ නැවත උත්සාහ කරන්න.

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

QuickDL සංකුචිත, පාරිභෝගික-විශේෂිත කොටසක් ලබා දී ඒකකය අසථායික නොවන ආකාරයෙන් ඒකාබද්ධ කිරීමට සහාය වේ.

අයිඩම්පොටන්ට් යෙදුම් ලොජික් භාවිතා කරන්න සහ එකම පරිශීලක ක්ලික් සඳහා නකල් රැකියා කිසි විටෙකත් ආරම්භ නොකරන්න.
සංක්ෂිප්තව මැටාදත්ත විසඳන්න, නමුත් සෑම විටම අත්සන් කළ බාගත URL කාලසීමාව ඉක්මවා යන බව සැලකිල්ලට ගන්න.
සීමාසහිත ප්‍රතිගාමී ප්‍රතිචාරය සහිතව භාවිතා කරන්න 429, 503 සහ නැවත උත්සාහ කළ හැකි දෝෂ.
පොදු මාධ්‍ය හෝ ඔබට ප්‍රවේශ වීමට අනුමත කරන ලද මාධ්‍ය පමණක් සැකසිය යුතුය. DRM සහ ප්‍රවේශ පාලන ඉවත නොහැරේ.
අයදුම්පත් හැඳුනුම් අංක සහ රැකියා හැඳුනුම් අංක පෞද්ගලික මෙහෙයුම් ලොග් වල තබා ගන්න. ඉදිරිපත් කළ URL අතිරික්තව ලොග් නොකරන්න.

QuickDL හි, Schema ප්‍රවේශය පැහැදිලි කිරීමේදී පරීක්ෂණයට පෙර සක්‍රීය කිරීම ප්‍රථම වේ. එම සංකීර්ණ උපකරණය පවරා ඇති සත්‍යාපනය සමඟ අනුගමනය කරමින් ලේඛිත ඉල්ලීම් ආකෘති මත අවසන් වේ.

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

සහාය මඟින් සක්‍රීය කරන්න

එක්සත් කිරීමේ නාමය, අපේක්ෂිත මාසික පරිමාව සහ අවශ්‍ය මූලාශ්‍ර QuickDL වෙත ලබා දෙන්න. සේවාදායකයා ක්‍රියාත්මක කරන මෙහෙයුම් හඳුනා ගන්න, එවිට අනුමැතිය සීමිත, එක් වතාවක් භාවිතා කළ හැකි යතුරක් නිපදවයි.

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