https://ytsave.appYTSave ସହିତ ଡାଉନଲୋଡ୍ ତିଆରି କରନ୍ତୁ
ଏକ ସାଧାରଣ ମାଧ୍ୟମ URL ନିରାକରଣ କରନ୍ତୁ, ଏକ ସଠିକ୍ ଫର୍ମାଟ୍ ବାଛନ୍ତୁ, ଏକ ଅସମ୍ମିଳିତ କାର୍ଯ୍ୟ ସୃଷ୍ଟି କରନ୍ତୁ ଏବଂ ସହିତ ସହିତ ଫଳାଫଳକୁ ଆପଣଙ୍କର ବ୍ୟବହାରକାରୀଙ୍କୁ ଦିଅନ୍ତୁ। ସେହି ସୀମିତ ଉତ୍ପାଦନ ପାଇପଲାଇନ୍ YTSave ୱେବସାଇଟ୍ କୁ ସଚଳ କରେ।
ତ୍ୱରିତ ଆରମ୍ଭ
YTSave ପ୍ରଥମେ ସମର୍ଥିତ-ସକ୍ରିୟ କ୍ରେଡେନ୍ସିଆଲ୍ଗୁଡିକୁ ଚିହ୍ନଟ କରି API ହୋଷ୍ଟ୍କୁ ହାଣ୍ଡଲ୍ କରେ। ଏହା ପରେ ଏକ ନିର୍ଦ୍ଧାରିତ ଟେନାଣ୍ଟ୍ ଏଣ୍ଡପଏଣ୍ଟ୍ ଅନୁସରଣ କରେ ଏବଂ ସର୍ଭର୍-ମାତ୍ର କଲ୍ ପଥକୁ ଦୃଷ୍ଟିରେ ରଖେ।
X-API-Key: ys_live_…YTSaveClientv1# 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 ପ୍ରଥମେ ସ୍ରୋତ ଚିହ୍ନଟ କରି Resolve କାର୍ଯ୍ୟକୁ ହାତଲ କରେ। ଏହା ଗୋଟିଏ ଦାଖଲ କରାଯାଇଥିବା 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"}'job_id.GET /v1/jobs/{job_id} ସେହି ଚାବି ସହିତ।| ସ୍ଥିତି | ଅର୍ଥ | ଗ୍ରାହକ କାର୍ଯ୍ୟ |
|---|---|---|
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 ଜବ୍ ପୋଲିଂକୁ ସହଜରେ ସ୍କ୍ୟାନ୍ କରିବାକୁ ସହାୟକ କରେ। ପୃଷ୍ଠାଟି ଗୋଟିଏ ସେକେଣ୍ଡର ପ୍ରାରମ୍ଭିକ ପ୍ରତୀକ୍ଷା ସହିତ ଆରମ୍ଭ ହୁଏ, ସୀମିତ ବ୍ୟାକଅଫ୍ ଦିଗକୁ ଗତି କରେ, ଏବଂ ସ୍ପଷ୍ଟ ଭାବରେ ଅସ୍ଥାୟୀ ସାଇନ୍ ଡିଲିଭରୀକୁ ଉଲ୍ଲେଖ କରେ।
ପୂର୍ବାନୁମାନିତ ତ୍ରୁଟିଗୁଡିକ
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 | କ୍ୟୁ/କ୍ଷମତା କିମ୍ବା ଅପସ୍ରୋତ ସ୍ଥାୟୀଭାବେ ଅପଲବ୍ଧ ନୁହେଁ। | ଏକ୍ସପୋନେନ୍ସିଆଲ୍ ବ୍ୟାକଅଫ୍ ଏବଂ ଜିଟର୍ ସହିତ ପୁନଃଚେଷ୍ଟା କରନ୍ତୁ। |
ସଂଚାଳନା ଚୁକ୍ତି
YTSave ପ୍ରତ୍ୟେକ ଅନୁମୋଦନ ସହିତ ଏକ କାର୍ଯ୍ୟାତ୍ମକ କ୍ୱୋଟା ଜାରି କରେ ଯାହା API ଉପଭୋକ୍ତା ଏବଂ ଉପରି ମିଡିଆ ସେବାଗୁଡିକୁ ସୁରକ୍ଷିତ କରିଥାଏ।
- ଏକ ଇଡେମ୍ପୋଟେଣ୍ଟ ଆପ୍ଲିକେସନ୍ ତର୍କ ବ୍ୟବହାର କରନ୍ତୁ ଏବଂ ସେହି ଉପଯୋଗକର୍ତ୍ତା କ୍ଲିକ୍ ପାଇଁ କେବେ ଡୁପ୍ଲିକେଟ୍ କାର୍ଯ୍ୟ ଆରମ୍ଭ କରନ୍ତୁ ନାହିଁ।
- କ୍ୟାଚେ ମେଟାଡାଟା ସଂକ୍ଷିପ୍ତ ଭାବରେ ସମାଧାନ କରନ୍ତୁ, କିନ୍ତୁ ସଦା ସହିତ ସହିତ ଡାଉନଲୋଡ୍ URL ଗୁଡିକୁ ସମୟ ସୀମିତ ବୋଲି ଗ୍ରହଣ କରନ୍ତୁ।
- ଜିଟର ସହିତ ବାଉଣ୍ଡ ଏକ୍ସପୋନେନ୍ସିଆଲ୍ ବ୍ୟାକଅଫ୍ ବ୍ୟବହାର କରନ୍ତୁ
429,503ଏବଂ ପୁନଃଚେଷ୍ଟା ଯୋଗ୍ୟ ତ୍ରୁଟିଗୁଡିକ। - କେବଳ ସାଧାରଣ ମିଡିଆ କିମ୍ବା ଆପଣ ଯାହାକୁ ପ୍ରବେଶ କରିବାକୁ ଅଧିକୃତ, ସେହି ମିଡିଆକୁ ପ୍ରକ୍ରିୟା କରନ୍ତୁ। DRM ଏବଂ ପ୍ରବେଶ ନିୟନ୍ତ୍ରଣଗୁଡିକୁ ବାଇପାସ୍ କରାଯାଉନାହିଁ।
- ନିଜସ୍ୱ କାର୍ଯ୍ୟାନୁଷ୍ଠାନ ଲଗ୍ଗୁଡିକରେ ଅନୁରୋଧ ID ଏବଂ କାମ ID ରଖନ୍ତୁ। ଅନାବଶ୍ୟକ ଭାବେ ଦାଖଲ କରାଯାଇଥିବା URL ଲଗ୍ କରନ୍ତୁ ନାହିଁ।
YTSave ସ୍କିମା ପ୍ରବେଶକୁ ପ୍ରଥମେ ସକ୍ରିୟତା ଚିହ୍ନଟ କରି ପରେ ଅନ୍ୱେଷଣ କରି ହାଣ୍ଡଲ୍ କରେ। ଏହା ନିଯୁକ୍ତ ପ୍ରମାଣୀକରଣକୁ ଅନୁସରଣ କରେ ଏବଂ ଦଲିଲ ଅନୁରୋଧ ଆକୃତିଗୁଡିକୁ ଦୃଶ୍ୟରେ ରଖେ। ଓପେନଏପିଆଇ ସନ୍ଦର୍ଭ
ଆପଣଙ୍କର API କୀ ଅନୁରୋଧ କରନ୍ତୁ
API ଉପଭୋକ୍ତା, ତାହାର ମାସିକ ଅନୁରୋଧ ଅନୁମାନ ଏବଂ ସମର୍ଥିତ ପ୍ଲାଟଫର୍ମ ଆବଶ୍ୟକତାଗୁଡ଼ିକୁ ଡକ୍ୟୁମେଣ୍ଟ କରନ୍ତୁ। YTSave ନିର୍ଣ୍ଣୟ କରେ କି ରିଜଲ୍ଭ, ଜବ୍ ସବମିସନ୍ କିମ୍ବା ଦୁହେଁ ଯୁକ୍ତିସଙ୍ଗତ କି ନୁହେଁ, ଏବଂ ଏକଥର ଦେଖାଯାଇଥିବା କୀ ଇସ୍ୟୁ କରିବା ପୂର୍ବରୁ।
API ପ୍ରବେଶ ଅନୁରୋଧ କରନ୍ତୁ କୀଗୁଡିକ ଟେନାଣ୍ଟ-ସ୍କୋପ୍ ହୋଇଥାଏ, ପୁନଃବାତିଲ କରାଯାଇପାରିବା ଏବଂ Contact ଫର୍ମ୍ ମାଧ୍ୟମରେ ଇସ୍ୟୁ କରାଯାଇଥାଏ। ଅନାନୋନିମସ୍ ସ୍କ୍ରିପ୍ଟଗୁଡିକ ଡାଉନଲୋଡର୍ କାମ କରାଇପାରିବେ ନାହିଁ।