https://ytsave.appYTSave ഉപയോഗിച്ച് ഡൗൺലോഡുകൾ നിർമ്മിക്കുക
ഒരു പൊതു മീഡിയ URL പരിഹരിക്കുക, കൃത്യമായ ഫോർമാറ്റ് തിരഞ്ഞെടുക്കുക, അസിങ്ക്രോണസ് ജോബ് സൃഷ്ടിക്കുക, ഒപ്പിട്ട ഫലം നിങ്ങളുടെ ഉപയോക്താവിന് കൈമാറുക. അതേ നിയന്ത്രിത ഉത്പാദന പൈപ്പ്ലൈൻ YTSave വെബ്സൈറ്റ് പ്രവർത്തിപ്പിക്കുന്നു.
YTSaveClientHTTPS വഴി JSONഅസിങ്ക്രോണസ് ജോലികൾപരിധിയിട്ട ക്രെഡൻഷ്യലുകൾ
01
വേഗത്തിലുള്ള ആരംഭം
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 സെർവർ-സൈഡ് രഹസ്യ സംഭരണം ക്ലയന്റ് ബണ്ടിൽ ഉൾപ്പെടുത്തലിൽ നിന്ന് വേർതിരിക്കുന്നു. ഒരു തെളിവ് രേഖക്ക് പൊതു ലോഗുകളും സംഭരണശാലകളും സ്വന്തം സ്ഥലം നൽകുന്നില്ല.
02
ഒരു ലിങ്ക് പരിഹരിക്കുക
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 തിരികെ ലഭിക്കുന്ന മൂല്യം ലിങ്ക്-പ്രതി ലഭ്യതയിൽ നിന്ന് മാറ്റമില്ലാതെ വേർതിരിക്കുന്നു. ഒരു തെളിവ് രേഖക്ക് അനുമാനിച്ച ഗുണനിലവാര ലേബലിന് സ്വന്തം സ്ഥാനം നൽകാറില്ല.
03
ഒരു ഡൗൺലോഡ് ജോബ് സൃഷ്ടിക്കുകയും പിന്തുടരുകയും ചെയ്യുക
ജോബ് സൃഷ്ടിക്കലിന്, 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 ജോബ് പോളിംഗ് എളുപ്പത്തിൽ സ്കാൻ ചെയ്യാൻ സഹായിക്കുന്നു. പേജ് ഒരു സെക്കൻഡ് പ്രാരംഭ കാത്തിരിപ്പോടെ ആരംഭിച്ച്, പരിമിതമായ ബാക്ക്ഓഫിലേക്ക് മാറുന്നു, താൽക്കാലിക ഒപ്പിട്ട ഡെലിവറി വ്യക്തമാക്കുന്നു.
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 ഉപഭോക്താവിനെയും മുകളിൽ നിന്നുള്ള മീഡിയ സേവനങ്ങളെയും സംരക്ഷിക്കാൻ ഓരോ അംഗീകാരത്തോടും പ്രവർത്തന ക്വോട്ട നൽകുന്നു.
- ഐഡംപോട്ടന്റ് ആപ്ലിക്കേഷൻ ലജിക് ഉപയോഗിച്ച് ഒരേ ഉപയോക്തൃ ക്ലിക്കിനായി ഡ്യൂപ്ലിക്കേറ്റ് ജോലികൾ ഒരിക്കലും ആരംഭിക്കരുത്.
- കാഷെ പരിഹരിക്കുന്ന മെറ്റാഡേറ്റാ താൽക്കാലികമായി സൂക്ഷിക്കുക, പക്ഷേ ഒപ്പിട്ട ഡൗൺലോഡ് URL-കൾ എപ്പോഴും കാലഹരണപ്പെടുന്നവയായി പരിഗണിക്കുക.
- ജിറ്ററോടുകൂടിയ ബൗണ്ടഡ് എക്സ്പൊണൻഷ്യൽ ബാക്ക്ഓഫ് ഉപയോഗിക്കുക
429,503മറ്റും പുനരായോഗ്യമായ പിശകുകൾ. - പൊതു മീഡിയ അല്ലെങ്കിൽ നിങ്ങൾക്ക് പ്രവേശനം അനുവദിച്ചിരിക്കുന്ന മീഡിയ മാത്രം പ്രോസസ്സ് ചെയ്യുക. DRMയും പ്രവേശന നിയന്ത്രണങ്ങളും മറികടക്കില്ല.
- അഭ്യർത്ഥന ഐഡികളും ജോബ് ഐഡികളും സ്വകാര്യ പ്രവർത്തന ലോഗുകളിൽ സൂക്ഷിക്കുക. സമർപ്പിച്ച URLകൾ അനാവശ്യമായി ലോഗ് ചെയ്യരുത്.
YTSave സ്കീമ ആക്സസ് കൈകാര്യം ചെയ്യുന്നത് ആദ്യം സജീവമാക്കൽ തിരിച്ചറിയുന്നതിലൂടെ ആരംഭിക്കുന്നു. തുടർന്ന് നിയോഗിച്ച പ്രാമാണീകരണം പിന്തുടരുന്നു, രേഖപ്പെടുത്തിയ അഭ്യർത്ഥന രൂപങ്ങൾ കാഴ്ചയിൽ സൂക്ഷിക്കുന്നു. ഓപ്പൺഎപിഐ റഫറൻസ്
നിങ്ങളുടെ API കീ അഭ്യർത്ഥിക്കുക
API ഉപഭോക്താവിനെ, അതിന്റെ മാസാന്ത അഭ്യർത്ഥനാ കണക്കുകൂട്ടലും പിന്തുണയുള്ള പ്ലാറ്റ്ഫോം ആവശ്യകതകളും രേഖപ്പെടുത്തുക. YTSave ഒരു തവണ കാണിച്ച കീ പുറപ്പെടുവിക്കുന്നതിന് മുമ്പ് പരിഹാരം, ജോബ് സമർപ്പിക്കൽ അല്ലെങ്കിൽ ഇരുവരും നീതിയുള്ളതാണോ എന്ന് പരിശോധിക്കുന്നു.
API ആക്സസ് അഭ്യർത്ഥിക്കുക കീകൾ വാടകക്കാരന്റെ പരിധിയിലുള്ളവയാണ്, റദ്ദാക്കാവുന്നതും കോൺടാക്റ്റ് ഫോമിലൂടെ നൽകപ്പെടുന്നതുമാണ്. അനാമക സ്ക്രിപ്റ്റുകൾ ഡൗൺലോഡർ ജോലികൾ നടത്താൻ കഴിയില്ല.