ପ୍ରୋଡକ୍ସନ୍ ରେଷ୍ଟ୍ 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 ପ୍ରଥମେ ସ୍ରୋତ ଚିହ୍ନଟ କରି Resolve କାର୍ଯ୍ୟକୁ ହାତଲ କରେ। ଏହା ଗୋଟିଏ ଦାଖଲ କରାଯାଇଥିବା 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 ଏକ ସମର୍ଥନ ଅନୁରୋଧ 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 ପ୍ରବେଶ ଅନୁରୋଧ କରନ୍ତୁ କୀଗୁଡିକ ଟେନାଣ୍ଟ-ସ୍କୋପ୍ ହୋଇଥାଏ, ପୁନଃବାତିଲ କରାଯାଇପାରିବା ଏବଂ Contact ଫର୍ମ୍ ମାଧ୍ୟମରେ ଇସ୍ୟୁ କରାଯାଇଥାଏ। ଅନାନୋନିମସ୍ ସ୍କ୍ରିପ୍ଟଗୁଡିକ ଡାଉନଲୋଡର୍ କାମ କରାଇପାରିବେ ନାହିଁ।