API ផលិតកម្ម REST · v1

បង្កើតការទាញយកជាមួយ YTSave

ដោះស្រាយ URL មេឌៀសាធារណៈ ជ្រើសរើសទ្រង់ទ្រាយត្រឹមត្រូវ បង្កើតការងារមិនសម័យ និងផ្តល់លទ្ធផលដែលបានចុះហត្ថលេខា ទៅអ្នកប្រើរបស់អ្នក។ បណ្តាញផលិតកម្មដូចគ្នានេះគឺជាថាមពលសម្រាប់គេហទំព័រ YTSave។

YTSaveClientJSON តាមរយៈ HTTPSការងារមិនសម័យសញ្ញាប័ត្រដែលមានដែនកំណត់

ចាប់ផ្តើមរហ័ស

YTSave គ្រប់គ្រងម៉ាស៊ីនបម្រើ API ដោយសម្គាល់សញ្ញាប័ត្រដែលបានបើកប្រើការគាំទ្រជាលើកដំបូង។ វាតាមដានជាមួយចំណុចបញ្ចប់អ្នកជួលដែលបានចាត់តាំង និងរក្សាផ្លូវហៅម៉ាស៊ីនបម្រើតែម្ដងឲ្យមើលឃើញ។

URL ជួលhttps://ytsave.app

ការផ្ទៀងផ្ទាត់X-API-Key: ys_live_…

ប្រវត្តិរូបអតិថិជនYTSaveClient

កំណែ APIv1

# 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 មួយដែលបានដាក់ស្នើ ហើយមិនរក្សាលទ្ធផលដែលបានបង្កើតឡើងក្នុងទិដ្ឋភាពទេ។

POST/v1/resolveវិសាលភាព៖ ដោះស្រាយ

វាល	ប្រភេទ	ត្រូវការ	ការពិពណ៌នា
`url`	URL HTTPS	បាទ/ចាស	ទំព័រព័ត៌មានសាធារណៈ ឬមានអាជ្ញាប័ណ្ណសម្រាប់វិភាគ។
`tenant`	ខ្សែអក្សរ	ទេ	ដែនជួលដែលបានចាត់តាំង។ ជាទូទៅមិនបង្ហាញ។

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

ដើម្បីពន្យល់អំពីអ្នកសម្គាល់ទ្រង់ទ្រាយ, YTSave បំបែកតម្លៃដែលត្រូវបានត្រឡប់មកវិញដោយមិនផ្លាស់ប្តូរពីភាពអាចប្រើបានតាមតំណ។ កំណត់ត្រាភស្តុតាងមិនផ្តល់ស្លាកគុណភាពដែលបានសន្មត់ឲ្យមានទីតាំងផ្ទាល់ខ្លួនទេ។

បង្កើត និងតាមដានការងារទាញយក

សម្រាប់ការបង្កើតការងារ YTSave ចាប់ផ្តើមជាមួយការរៀបចំអាស៊ីនខណៈ។ កំណត់ត្រាភស្តុតាងរបស់វាបញ្ចូលសំណើ HTTP ខ្លី ហើយបញ្ចប់ជាមួយការប្រតិបត្តិការកម្មករដែលមានដែនកំណត់។

POST/v1/jobsវិសាលភាព៖ ការងារ

វាល	ប្រភេទ	ត្រូវការ	ការពិពណ៌នា
`url`	URL HTTPS	បាទ/ចាស	ប្រភពធម្មតាដូចគ្នាត្រូវបានដាក់ស្នើដើម្បីដោះស្រាយ។
`format_id`	ខ្សែអក្សរ	បាទ/ចាស	អត្តសញ្ញាណជាក់លាក់ពីការឆ្លើយតប resolve។
`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`	កំហុសរចនាសម្ព័ន្ធ Terminal។	អាន `error_code`. សាកល្បងម្តងទៀតតែពេលដែលបានណែនាំ។
`expired`	លទ្ធផលបណ្តោះអាសន្នត្រូវបានលុបចោល។	បង្កើតការងារថ្មីមួយ។

curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSave ធ្វើឱ្យការត្រួតពិនិត្យការងារងាយស្រួល។ ទំព័រចាប់ផ្តើមជាមួយការរង់ចាំដើមមួយវិនាទី បន្តទៅការកំណត់ពេលវេលាឡើងវិញ ហើយបញ្ជាក់យ៉ាងច្បាស់ពីការដឹកជញ្ជូនដែលបានចុះហត្ថលេខាបណ្តោះអាសន្ន។

កំហុសដែលអាចទាយបាន

សម្រាប់កិច្ចសន្យាខុសឆ្គង YTSave ពិនិត្យកញ្ចប់មួយដែលមិនមែន 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	ជួរដេក/សមត្ថភាព ឬ upstream មិនអាចប្រើបានបណ្តោះអាសន្ន។	ព្យាយាមម្តងទៀតជាមួយការពន្យារពេលបូកបន្ថែម និងការប្រែប្រួល។

កិច្ចសន្យាដំណើរការ

YTSave ផ្តល់កម្រិតប្រតិបត្តិការជាមួយការអនុម័តនីមួយៗ ដើម្បីការពារអ្នកប្រើប្រាស់ API និងសេវាកម្មមេឌៀខាងលើ។

ប្រើតុល្យភាពកម្មវិធីដែលអាចធ្វើឡើងឡើងវិញ ហើយកុំចាប់ផ្តើមការងារចម្លងសម្រាប់ការចុចអ្នកប្រើដូចគ្នា។
ផ្ទុកទិន្នន័យមេតាដាតាបានយ៉ាងខ្លី ប៉ុន្តែតែងតែព្យាបាល URL ទាញយកដែលបានចុះហត្ថលេខាថាជាកំពុងផុតកំណត់។
ប្រើការពន្យារពេលបូកបន្ថែមជាមួយការប្រែប្រួលសម្រាប់ 429, 503 និងកំហុសដែលអាចព្យាយាមម្តងទៀត។
ដំណើរការតែប្រព័ន្ធផ្សព្វផ្សាយសាធារណៈ ឬប្រព័ន្ធផ្សព្វផ្សាយដែលអ្នកមានសិទ្ធិចូលប្រើ។ មិនអាចលុបចោល DRM និងការគ្រប់គ្រងការចូលប្រើបានទេ។
រក្សាទុកលេខសម្គាល់សំណើ និងលេខសម្គាល់ការងារនៅក្នុងកំណត់ហេតុប្រតិបត្តិការឯកជន។ កុំកត់ត្រា URL ដែលបានដាក់ស្នើដោយមិនចាំបាច់។

YTSave គ្រប់គ្រងការចូលប្រើ Schema ដោយសម្គាល់ការបើកប្រើជាមុនមុនការស្វែងរក។ វាដើរតាមការផ្ដល់សិទ្ធិផ្ទៀងផ្ទាត់ និងរក្សាទម្រង់សំណើដែលបានចុះបញ្ជីនៅក្នុងទិដ្ឋភាព។ យោង OpenAPI

ចូលប្រើដោយបានពិនិត្យដោយអ្នកប្រតិបត្តិការ

ស្នើសុំកូនសោ API របស់អ្នក

ចុះបញ្ជីអ្នកប្រើប្រាស់ API ការប៉ាន់ប្រមាណសំណើប្រចាំខែ និងតម្រូវការផ្លាតហ្វូមដែលគាំទ្រ។ YTSave ពិនិត្យមើលថាតើការដោះស្រាយ ការដាក់ស្នើការងារ ឬទាំងពីរត្រូវបានយុត្តិធម៌មុនពេលចេញកូនសោដែលមើលឃើញម្តង។

ស្នើសុំការចូលប្រើ API កូនសោត្រូវបានកំណត់ជាតំបន់អ្នកជួល, អាចលុបចោលបាន និងចេញផ្សាយតាមរយៈទម្រង់ទំនាក់ទំនង។ ស្គ្រីបអនាមិកមិនអាចអនុវត្តការងារទាញយកបានទេ។