પ્રોડક્શન રેસ્ટ API · v1

YTSave સાથે ડાઉનલોડ બનાવો

જાહેર મીડિયા URL હલ કરો, ચોક્કસ ફોર્મેટ પસંદ કરો, અસિંક્રોનસ નોકરી બનાવો અને સહી કરેલ પરિણામ તમારા વપરાશકર્તા સુધી પહોંચાડો. તે જ સીમિત ઉત્પાદન પાઇપલાઇન YTSave વેબસાઇટને શક્તિ આપે છે.

YTSaveClientHTTPS પર JSONઅસિંક્રોનસ નોકરીઓવિશિષ્ટ પ્રમાણપત્રો

ઝડપી શરૂઆત

YTSave એપીઆઈ હોસ્ટને પ્રથમ સપોર્ટ-સક્રિયિત પ્રમાણપત્રો ઓળખીને સંભાળે છે. તે નિમણૂક કરેલા ટેનન્ટ એન્ડપોઈન્ટ સાથે આગળ વધે છે અને સર્વર-માત્ર કોલ પાથ દૃશ્યમાં રાખે છે.

ટેનેન્ટ URLhttps://ytsave.app

પ્રમાણિકરણX-API-Key: ys_live_…

ક્લાયન્ટ પ્રોફાઇલYTSaveClient

એપીઆઈ સંસ્કરણ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 સર્વર-સાઇડ સિક્રેટ સ્ટોરેજને ક્લાયન્ટ બંડલ એમ્બેડિંગથી અલગ કરે છે. એક પુરાવા રેકોર્ડ કોઈ જાહેર લોગ્સ અથવા રિપોઝિટરીઝને પોતાનું સ્થાન આપતું નથી.

લિંક ઉકેલો

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"}'

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 નોકરી પોલિંગને સરળ બનાવે છે. પેજ એક સેકન્ડની પ્રારંભિક રાહ જોઈને શરૂ થાય છે, પછી મર્યાદિત બેકઓફ તરફ જાય છે અને ટેમ્પરરી સહી કરેલી ડિલિવરી સ્પષ્ટ રીતે જણાવે છે.

અંદાજ લગાવી શકાય તેવા ભૂલો

એરર કોન્ટ્રાક્ટ માટે, 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 અને ઍક્સેસ નિયંત્રણો અવગણવામાં આવતાં નથી.
વિનંતી આઈડીઓ અને નોકરી આઈડીઓને ખાનગી ઓપરેશનલ લોગ્સમાં રાખો. સબમિટ કરેલી URL અનાવશ્યક રીતે લોગ ન કરો.

YTSave સ્કીમા ઍક્સેસને પ્રથમ સક્રિયકરણ ઓળખીને હેન્ડલ કરે છે પછી અન્વેષણ કરે છે. તે નિમણૂક કરેલી પ્રમાણિકરણ સાથે આગળ વધે છે અને દસ્તાવેજીકૃત વિનંતી આકારોને દૃશ્યમાં રાખે છે. ઓપનએપીઆઈ સંદર્ભ

ઓપરેટર-સમીક્ષિત ઍક્સેસ

તમારી API કી માટે વિનંતી કરો

API વપરાશકર્તા, તેની માસિક વિનંતી અંદાજ અને સમર્થિત પ્લેટફોર્મ જરૂરિયાતો દસ્તાવેજ કરો. YTSave તપાસ કરે છે કે રિઝોલ્વ, નોકરી સબમિશન કે બંને યોગ્ય છે કે નહીં તે પહેલાં એક વખત દેખાવા લાયક કી જારી કરે.

API ઍક્સેસ માટે વિનંતી કરો કીસ ટેનન્ટ-સ્કોપ્ડ, રદ કરી શકાય તેવી અને સંપર્ક ફોર્મ દ્વારા જારી કરવામાં આવે છે. અનામી સ્ક્રિપ્ટ્સ ડાઉનલોડર કાર્ય ચલાવી શકતી નથી.