ਉਤਪਾਦਨ 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

ਪੇਸ਼ਗੀ ਅੰਦਾਜ਼ੇ ਵਾਲੀਆਂ ਗਲਤੀਆਂ

Error contract ਲਈ, YTSave ਇੱਕ ਗੈਰ-2xx ਲਿਫਾਫਾ ਚੈੱਕ ਕਰਦਾ ਹੈ ਸਹਾਇਤਾ ਬੇਨਤੀ ID ਤੋਂ ਪਹਿਲਾਂ। ਇਹ ਸਬੂਤ ਰਿਕਾਰਡ ਗਾਹਕ ਦੇ ਸੰਭਾਲਣ ਨੂੰ ਸਪਸ਼ਟ ਬਣਾਉਂਦਾ ਹੈ।

{
  "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 ਸਕੀਮਾ ਐਕਸੈਸ ਨੂੰ ਪਹਿਲਾਂ ਐਕਟੀਵੇਸ਼ਨ ਦੀ ਪਛਾਣ ਕਰਕੇ ਸੰਭਾਲਦਾ ਹੈ, ਫਿਰ ਨਿਰਧਾਰਿਤ ਪ੍ਰਮਾਣਿਕਤਾ ਨਾਲ ਅੱਗੇ ਵਧਦਾ ਹੈ ਅਤੇ ਦਰਜ ਕੀਤੇ ਗਏ ਬੇਨਤੀ ਆਕਾਰਾਂ ਨੂੰ ਨਜ਼ਰ ਵਿੱਚ ਰੱਖਦਾ ਹੈ। OpenAPI ਸੰਦਰਭ

ਓਪਰੇਟਰ-ਸਮੀਖਿਆ ਕੀਤੀ ਪਹੁੰਚ

ਆਪਣਾ API ਕੁੰਜੀ ਮੰਗੋ

API ਉਪਭੋਗਤਾ, ਇਸ ਦੀ ਮਹੀਨਾਵਾਰ ਬੇਨਤੀ ਅੰਦਾਜ਼ਾ ਅਤੇ ਸਮਰਥਿਤ ਪਲੇਟਫਾਰਮ ਲੋੜਾਂ ਦਾ ਦਸਤਾਵੇਜ਼ ਬਣਾਓ। YTSave ਜਾਂਚਦਾ ਹੈ ਕਿ ਕੀ ਰਿਜ਼ੋਲਵ, ਨੌਕਰੀ ਸਬਮਿਸ਼ਨ ਜਾਂ ਦੋਹਾਂ ਨੂੰ ਇੱਕ ਵਾਰੀ-ਦਿੱਖਾਈ ਕੁੰਜੀ ਜਾਰੀ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਜਾਇਜ਼ ਹੈ।

API ਪਹੁੰਚ ਦੀ ਬੇਨਤੀ ਕਰੋ ਕੀਜ਼ ਟੇਨੈਂਟ-ਸਕੋਪਡ, ਰੱਦ ਕੀਤੀਆਂ ਜਾ ਸਕਦੀਆਂ ਹਨ ਅਤੇ ਸੰਪਰਕ ਫਾਰਮ ਰਾਹੀਂ ਜਾਰੀ ਕੀਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ। ਗੁਪਤ ਸਕ੍ਰਿਪਟ ਡਾਊਨਲੋਡਰ ਕੰਮ ਨਹੀਂ ਚਲਾ ਸਕਦੇ।