https://ytsave.appYTSave සමඟ ගොනු බාගත කරන්න
පොදු මාධ්ය URL එකක් විසඳන්න, නිවැරදි ආකෘතියක් තෝරන්න, අසමකාලීන රැකියාවක් නිර්මාණය කරන්න සහ අත්සන් කළ ප්රතිඵලය ඔබේ පරිශීලකයාට ලබා දෙන්න. එම සීමාසහිත නිෂ්පාදන නළය YTSave වෙබ් අඩවියට බලය සපයයි.
ඉක්මන් ආරම්භය
YTSave පළමුව සහයෝගිතාව සක්රීය කළ අක්තපත්ර හඳුනාගෙන API සත්කාරකය කළමනාකරණය කරයි. එය පසුව පවරා ඇති කුලීකරු අවසානයක් අනුගමනය කරමින් සේවාදායක-මात्र ඇමතුම් මාර්ගයක් දෘශ්යමාන කරයි.
X-API-Key: ys_live_…YTSaveClientv1# 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 සේවාදායක පාර්ශ්ව රහස් ගබඩා කිරීම සහ ගනුදෙනුකරු පැකේජය ඇතුළත් නොකිරීම වෙන් කරයි. සාක්ෂි වාර්තාවක් පොදු ලොග් හෝ ගබඩා ස්ථාන සඳහා ස්ථානයක් ලබා නොදේ.
සබැඳිය විසඳන්න
YTSave විසඳුම් මෙහෙයුම කළමනාකරණය කරන්නේ පළමුව මූලාශ්ර හඳුනා ගැනීම හඳුනාගෙනය. එය එක් ඉදිරිපත් කළ URL එකක සිට ආකෘති අනුගමනය කරයි සහ දෘශ්යයේ නිර්මාණය කළ ප්රතිදාන කිසිවක් තබන්නේ නැත.
/v1/resolveපරාසය: විසඳන්න| ක්ෂේත්රය | වර්ගය | අවශ්ය | විස්තරය |
|---|---|---|---|
url | HTTPS URL | ඔව් | විශ්ලේෂණය සඳහා මහජන හෝ අනුමත මාධ්ය පිටුවක්. |
tenant | ස්ට්රිං | නැත | පවරා ඇති කුලීකරුවන්ගේ ඩොමේනය. සාමාන්යයෙන් අතහැර දමයි. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}ආකෘති හැඳුනුම්පත පැහැදිලි කිරීමට, YTSave සම්බන්ධතා-අවශ්යතාවයෙන් වෙනස් නොවූ ආපසු ලැබුණු අගය වෙන් කරයි. සාක්ෂි වාර්තාවක් කිසිදු අනුමානිත ගුණාත්මක ලේබලයක් සඳහා ස්ථානයක් ලබා නොදේ.
බාගත කිරීමේ කාර්යයක් නිර්මාණය කර අනුගමනය කරන්න
රැකියා නිර්මාණය සඳහා, YTSave අසමකාලීන සූදානමෙන් ආරම්භ කරයි. එහි සාක්ෂි වාර්තාව කෙටි HTTP ඉල්ලීමක් සමඟ ඒකරාශී කරයි සහ සීමාසහිත කාර්ය මණ්ඩල ක්රියාත්මක කිරීමෙන් අවසන් කරයි.
/v1/jobsපරාසය: රැකියා| ක්ෂේත්රය | වර්ගය | අවශ්ය | විස්තරය |
|---|---|---|---|
url | HTTPS 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"}'job_id.GET /v1/jobs/{job_id} එම යතුර සමඟ.| තත්ත්වය | අර්ථය | පාරිභෝගික ක්රියාව |
|---|---|---|
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ක ආරම්භක බලාපොරොත්තුවකින් ආරම්භ වෙයි, සීමාසහිත ප්රතික්ෂේපයට යයි, සහ තාවකාලික අත්සන් කළ බෙදාහැරීම පැහැදිලිව සඳහන් කරයි.
පූර්ව අනාවැකි දෝෂ
දෝෂ ගිවිසුම සඳහා, 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 | පෝරමය/සමර්ථතාව හෝ ඉහළ ගමන් මාර්ගය තාවකාලිකව ලබා ගත නොහැක. | ආරෝහණීය ප්රතික්ෂේප සහ කම්පනය සමඟ නැවත උත්සාහ කරන්න. |
මෙහෙයුම් ගිවිසුම
YTSave API පරිභෝජකයා සහ ඉහළ මට්ටමේ මාධ්ය සේවාවන් ආරක්ෂා කිරීම සඳහා සෑම අනුමත කිරීමකටත් මෙහෙයුම් කොටසක් නිකුත් කරයි.
- අයිඩම්පොටන්ට් යෙදුම් ලොජික් භාවිතා කරන්න සහ එකම පරිශීලක ක්ලික් සඳහා නකල් රැකියා කිසි විටෙකත් ආරම්භ නොකරන්න.
- සංක්ෂිප්තව මැටාදත්ත විසඳන්න, නමුත් සෑම විටම අත්සන් කළ බාගත URL කාලසීමාව ඉක්මවා යන බව සැලකිල්ලට ගන්න.
- සීමාසහිත ප්රතිගාමී ප්රතිචාරය සහිතව භාවිතා කරන්න
429,503සහ නැවත උත්සාහ කළ හැකි දෝෂ. - පොදු මාධ්ය හෝ ඔබට ප්රවේශ වීමට අනුමත කරන ලද මාධ්ය පමණක් සැකසිය යුතුය. DRM සහ ප්රවේශ පාලන ඉවත නොහැරේ.
- අයදුම්පත් හැඳුනුම් අංක සහ රැකියා හැඳුනුම් අංක පෞද්ගලික මෙහෙයුම් ලොග් වල තබා ගන්න. ඉදිරිපත් කළ URL අතිරික්තව ලොග් නොකරන්න.
YTSave යොදා ගන්නේ සක්රීය කිරීම හඳුනා ගැනීමෙන් පසුව Schema ප්රවේශයයි. එය පසුව පවරා ඇති සත්යාපනය අනුගමනය කරමින් ලේඛිත ඉල්ලීම් ආකෘති දර්ශනයේ තබයි. OpenAPI යොමුපත
ඔබගේ API යතුර ඉල්ලන්න
API පරිභෝජකයා, එහි මාසික ඉල්ලීම් අනුමානය සහ සහාය දක්වන වේදිකා අවශ්යතා ලේඛනය කරන්න. YTSave විසින් විසඳුම, රැකියා ඉදිරිපත් කිරීම හෝ දෙකම සාධාරණද යන්න සමාලෝචනය කර, එක් වතාවක් පෙනෙන යතුර නිකුත් කරයි.
API ප්රවේශය ඉල්ලන්න යතුරු කුලීකරුවන්ට සීමා කර ඇති අතර, අහඹු ලෙස අවලංගු කළ හැකි අතර සම්බන්ධතා පෝරමය හරහා නිකුත් කර ඇත. අනන්ය ලිපිනයන් බාගත කිරීමේ වැඩසටහන් ක්රියාත්මක කළ නොහැක.