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 | స్ట్రింగ్ | అవును | రిజాల్వ్ ప్రతిస్పందన నుండి ఖచ్చితమైన 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 ఒక సపోర్ట్ అభ్యర్థన ID ముందు ఒక నాన్-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 మరియు యాక్సెస్ నియంత్రణలు దాటవేయబడవు.
- అభ్యర్థన IDలు మరియు ఉద్యోగ IDలను ప్రైవేట్ ఆపరేషనల్ లాగ్లలో ఉంచండి. సమర్పించిన URLలను అనవసరంగా లాగ్ చేయవద్దు.
YTSave స్కీమా యాక్సెస్ను ముందుగా యాక్టివేషన్ను గుర్తించడం ద్వారా నిర్వహిస్తుంది. ఇది కేటాయించిన ధృవీకరణను అనుసరిస్తుంది మరియు డాక్యుమెంట్ చేయబడిన అభ్యర్థన ఆకారాలను వీక్షణలో ఉంచుతుంది. ఓపెన్ఏపీఐ సూచిక
మీ API కీని అభ్యర్థించండి
API వినియోగదారుని, దాని నెలవారీ అభ్యర్థన అంచనాను మరియు మద్దతు పొందిన ప్లాట్ఫారమ్ అవసరాలను డాక్యుమెంట్ చేయండి. YTSave ఒకసారి కనిపించే కీ జారీ చేయడానికి ముందు పరిష్కారం, ఉద్యోగ సమర్పణ లేదా రెండింటి అవసరం ఉందో లేదో సమీక్షిస్తుంది.
API యాక్సెస్ అభ్యర్థించండి కీలు టెనెంట్-స్కోప్ చేయబడ్డవి, రద్దు చేయదగినవి మరియు కాంటాక్ట్ ఫారమ్ ద్వారా జారీ చేయబడతాయి. అనామక స్క్రిప్టులు డౌన్లోడర్ పనిని అమలు చేయలేవు.