ಉತ್ಪಾದನಾ REST API · v1

YTSave ಮೂಲಕ ಡೌನ್ಲೋಡ್‌ಗಳನ್ನು ರಚಿಸಿ

ಸಾರ್ವಜನಿಕ ಮಾಧ್ಯಮ URL ಅನ್ನು ಪರಿಹರಿಸಿ, ನಿಖರವಾದ ಸ್ವರೂಪವನ್ನು ಆಯ್ಕೆಮಾಡಿ, ಅಸಿಂಕ್ರೋನಸ್ ಕೆಲಸವನ್ನು ರಚಿಸಿ ಮತ್ತು ಸಹಿ ಮಾಡಲಾದ ಫಲಿತಾಂಶವನ್ನು ನಿಮ್ಮ ಬಳಕೆದಾರರಿಗೆ ಹಸ್ತಾಂತರಿಸಿ. ಅದೇ ನಿಯಂತ್ರಿತ ಉತ್ಪಾದನಾ ಪೈಪ್‌ಲೈನ್ YTSave ವೆಬ್‌ಸೈಟ್ ಅನ್ನು ಚಾಲನೆ ಮಾಡುತ್ತದೆ.

YTSaveClientHTTPS ಮೂಲಕ JSONಅಸಿಂಕ್ರೋನಸ್ ಕೆಲಸಗಳುವಿಸ್ತೃತ ಪ್ರಮಾಣಪತ್ರಗಳು

ತ್ವರಿತ ಪ್ರಾರಂಭ

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 ಸರ್ವರ್-ಬದಿಯ ರಹಸ್ಯ ಸಂಗ್ರಹಣೆಯನ್ನು ಗ್ರಾಹಕ ಬಂಡಲ್ ಎम्बೆಡಿಂಗ್ ಇಲ್ಲದಂತೆ ವಿಭಜಿಸುತ್ತದೆ. ಒಂದು ಸಾಕ್ಷ್ಯ ದಾಖಲೆ ಯಾವುದೇ ಸಾರ್ವಜನಿಕ ಲಾಗ್‌ಗಳು ಅಥವಾ ಸಂಗ್ರಹಾಲಯಗಳಿಗೆ ತನ್ನದೇ ಆದ ಸ್ಥಳ ನೀಡುವುದಿಲ್ಲ.

ಲಿಂಕ್ ಪರಿಹರಿಸಿ

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 ಸ್ಕೀಮಾ ಪ್ರವೇಶವನ್ನು ಮೊದಲಿಗೆ ಸಕ್ರಿಯತೆಯನ್ನು ಗುರುತಿಸುವ ಮೂಲಕ ನಿರ್ವಹಿಸುತ್ತದೆ, ನಂತರ ನಿಯೋಜಿತ ಪ್ರಮಾಣೀಕರಣವನ್ನು ಅನುಸರಿಸುತ್ತದೆ ಮತ್ತು ದಾಖಲೆಗೊಳಿಸಿದ ವಿನಂತಿ ರೂಪಗಳನ್ನು ವೀಕ್ಷಣೆಯಲ್ಲಿ ಇಡುತ್ತದೆ. OpenAPI ಉಲ್ಲೇಖ

ಆಪರೇಟರ್-ಪರಿಶೀಲಿತ ಪ್ರವೇಶ

ನಿಮ್ಮ API ಕೀ ವಿನಂತಿಸಿ

API ಗ್ರಾಹಕ, ಅದರ ಮಾಸಿಕ ವಿನಂತಿ ಅಂದಾಜು ಮತ್ತು ಬೆಂಬಲಿತ ವೇದಿಕೆ ಅಗತ್ಯಗಳನ್ನು ದಾಖಲೆ ಮಾಡಿರಿ. YTSave ಒಂದು ಬಾರಿ ಕಾಣಿಸಿಕೊಳ್ಳುವ ಕೀ ನೀಡುವ ಮೊದಲು ಪರಿಹಾರ, ಕೆಲಸ ಸಲ್ಲಿಕೆ ಅಥವಾ ಎರಡೂ ನ್ಯಾಯಸಮ್ಮತವಾಗಿದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸುತ್ತದೆ.

API ಪ್ರವೇಶವನ್ನು ವಿನಂತಿಸಿ ಕೀಗಳು ಟೆನಂಟ್-ವಿಸ್ತೃತ, ರದ್ದುಮಾಡಬಹುದಾದ ಮತ್ತು ಸಂಪರ್ಕ ಫಾರ್ಮ್ ಮೂಲಕ ನೀಡಲ್ಪಡುವವು. ಅನಾಮಧೇಯ ಸ್ಕ್ರಿಪ್ಟ್‌ಗಳು ಡೌನ್ಲೋಡರ್ ಕೆಲಸವನ್ನು ನಿರ್ವಹಿಸಲು ಸಾಧ್ಯವಿಲ್ಲ.