ప్రొడక్షన్ 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 నుండి ఫార్మాట్లను అనుసరిస్తుంది మరియు వీక్షణలో ఎలాంటి ఆవిష్కృత అవుట్‌పుట్‌లను ఉంచదు.

పోస్ట్/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 ఒక సపోర్ట్ అభ్యర్థన 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క్యూలు/సామర్థ్యం లేదా అప్‌స్ట్రీమ్ తాత్కాలికంగా అందుబాటులో లేదు.ఎక్స్‌పోనెన్షియల్ బ్యాక్‌ఆఫ్ మరియు జిట్టర్‌తో మళ్లీ ప్రయత్నించండి.
05

ఆపరేషనల్ కాంట్రాక్ట్

YTSave ప్రతి ఆమోదంతో ఒక ఆపరేషనల్ కోటాను జారీ చేస్తుంది, ఇది API వినియోగదారుని మరియు అప్‌స్ట్రీమ్ మీడియా సేవలను రక్షిస్తుంది.

YTSave స్కీమా యాక్సెస్‌ను ముందుగా యాక్టివేషన్‌ను గుర్తించడం ద్వారా నిర్వహిస్తుంది. ఇది కేటాయించిన ధృవీకరణను అనుసరిస్తుంది మరియు డాక్యుమెంట్ చేయబడిన అభ్యర్థన ఆకారాలను వీక్షణలో ఉంచుతుంది. ఓపెన్‌ఏపీఐ సూచిక

ఆపరేటర్-సమీక్షించిన యాక్సెస్

మీ API కీని అభ్యర్థించండి

API వినియోగదారుని, దాని నెలవారీ అభ్యర్థన అంచనాను మరియు మద్దతు పొందిన ప్లాట్‌ఫారమ్ అవసరాలను డాక్యుమెంట్ చేయండి. YTSave ఒకసారి కనిపించే కీ జారీ చేయడానికి ముందు పరిష్కారం, ఉద్యోగ సమర్పణ లేదా రెండింటి అవసరం ఉందో లేదో సమీక్షిస్తుంది.

API యాక్సెస్ అభ్యర్థించండి కీలు టెనెంట్-స్కోప్ చేయబడ్డవి, రద్దు చేయదగినవి మరియు కాంటాక్ట్ ఫారమ్ ద్వారా జారీ చేయబడతాయి. అనామక స్క్రిప్టులు డౌన్లోడర్ పనిని అమలు చేయలేవు.