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 இல் இருந்து வடிவங்களை பின்பற்றுகிறது மற்றும் கற்பனை செய்யப்பட்ட output களை பார்வையில் வைக்காது.
/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 | சரம் | ஆம் | தீர்வு பதிலிலிருந்து ஒரு துல்லிய 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 வேலை வாக்கிங் எளிதாக ஸ்கேன் செய்ய உதவுகிறது. பக்கம் ஒரு வினாடி ஆரம்ப காத்திருப்புடன் துவங்கி, வரம்பு கொண்ட பின்னோக்கி நகர்கிறது, மற்றும் தற்காலிக கையொப்பமிடப்பட்ட விநியோகத்தை தெளிவாக குறிப்பிடுகிறது.
முன்கூட்டியே கணிக்கக்கூடிய பிழைகள்
பிழை ஒப்பந்தத்திற்காக, 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 ஸ்கீமா அணுகலை முதலில் செயல்படுத்தலை அடையாளம் காண்பதன் மூலம் கையாள்கிறது. பின்னர் ஒதுக்கப்பட்ட அங்கீகாரத்துடன் தொடர்கிறது மற்றும் கோரிக்கை வடிவங்களை பார்வையில் வைத்திருக்கிறது. OpenAPI குறிப்பு
உங்கள் API விசையை கோரவும்
API பயனாளரை, அதன் மாதாந்திர கோரிக்கை மதிப்பீடு மற்றும் ஆதரவு பெறும் தள தேவைகளை ஆவணப்படுத்தவும். YTSave தீர்மானம், வேலை சமர்ப்பிப்பு அல்லது இரண்டும் நியாயமானதா என்பதை ஒருமுறை காணப்படும் விசையை வழங்குவதற்கு முன் மதிப்பாய்வு செய்கிறது.
API அணுகலை கோருக சாவிகள் வாடிக்கையாளர்-அளவுக்குள், திரும்பப்பெறக்கூடியவை மற்றும் தொடர்பு படிவத்தின் மூலம் வழங்கப்படுகின்றன. பெயரில்லா ஸ்கிரிப்ட்கள் பதிவிறக்கி பணியை இயக்க முடியாது.