உற்பத்தி 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 இல் இருந்து வடிவங்களை பின்பற்றுகிறது மற்றும் கற்பனை செய்யப்பட்ட output களை பார்வையில் வைக்காது.

போஸ்ட்/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 கோரிக்கையுடன் இணைத்து கட்டுப்படுத்தப்பட்ட பணியாளர் செயல்பாட்டுடன் முடிக்கிறது.

போஸ்ட்/v1/jobsபரப்பு: வேலைகள்
புலம்வகைதேவைவிளக்கம்
urlHTTPS 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"}'
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 வேலை வாக்கிங் எளிதாக ஸ்கேன் செய்ய உதவுகிறது. பக்கம் ஒரு வினாடி ஆரம்ப காத்திருப்புடன் துவங்கி, வரம்பு கொண்ட பின்னோக்கி நகர்கிறது, மற்றும் தற்காலிக கையொப்பமிடப்பட்ட விநியோகத்தை தெளிவாக குறிப்பிடுகிறது.

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 ஸ்கீமா அணுகலை முதலில் செயல்படுத்தலை அடையாளம் காண்பதன் மூலம் கையாள்கிறது. பின்னர் ஒதுக்கப்பட்ட அங்கீகாரத்துடன் தொடர்கிறது மற்றும் கோரிக்கை வடிவங்களை பார்வையில் வைத்திருக்கிறது. OpenAPI குறிப்பு

ஆபரேட்டர்-சரிபார்த்த அணுகல்

உங்கள் API விசையை கோரவும்

API பயனாளரை, அதன் மாதாந்திர கோரிக்கை மதிப்பீடு மற்றும் ஆதரவு பெறும் தள தேவைகளை ஆவணப்படுத்தவும். YTSave தீர்மானம், வேலை சமர்ப்பிப்பு அல்லது இரண்டும் நியாயமானதா என்பதை ஒருமுறை காணப்படும் விசையை வழங்குவதற்கு முன் மதிப்பாய்வு செய்கிறது.

API அணுகலை கோருக சாவிகள் வாடிக்கையாளர்-அளவுக்குள், திரும்பப்பெறக்கூடியவை மற்றும் தொடர்பு படிவத்தின் மூலம் வழங்கப்படுகின்றன. பெயரில்லா ஸ்கிரிப்ட்கள் பதிவிறக்கி பணியை இயக்க முடியாது.