YTSave དང་འབྲེལ་བའི་འཛུལ་འཛུལ་རིམ་འཛུལ་བརྡ་འཕྲིན་བཟོ་བཅོས

# 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 ཡིས་སར་བར་ཕྱོགས་ཀྱི་གསང་གྲུབ་གསོག་ཉར་དང་ཚོང་སྒམ་ལྟ་བུའི་ཞོག་མཁས་ལ་མི་འཇུག་པ་དབྱེ་འབྱེད་བྱེད། དཔང་རྟགས་ཟིན་ཐོས་སྤྱི་སྟོན་ལོགས་ཀྱི་ལོག་མཛོད་སམ་མཛོད་ཁང་ལ་རང་གནས་མེད།

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

རྣམ་པའི་ངོས་འཛིན་སྟོན་ཆེད། YTSave ཡིས་ཕྱིར་ལོག་བྱུང་བའི་གྲངས་ཐང་དེ་སོར་གནས་སུ་བཞག་ནས་མཐུད་རེ་རེའི་ཐོབ་རུང་དང་ཁ་ཕྲལ་བྱེད། དཔང་རྟགས་ཟིན་ཐོ་ཞིག་གིས་དཔོག་ཚོད་ཀྱི་སྤུས་ཚད་མཚོན་རྟགས་ལ་སོ་སོའི་གནས་མི་སྟེར།

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"}'

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

YTSave ཡིས Job polling ལ་བཤེར་ཞིབ་བྱེད་པ་སླ་པོ་བཟོ་གི་ཡོད། ཤོག་ངོས་དེ་སྐར་ཆ་གཅིག་གི་ཐོག་མའི་སྒུག་དུས་ནས་འགོ་བཙུགས་ཏེ། capped backoff ལ་འགྲོ་ཞིང་། temporary signed delivery ཡོད་པ་གསལ་པོར་བཤད་ཀྱི་ཡོད།

{
  "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": "…"
}

• གནས་ཚུལ་གཅིག་བསྐྱར་བཀོལ་རུང་བའི་སྦྱོར་ལས་ཀྱི་ལག་ལེན་སྤྱོད་ནས། སྤྱོད་མིའི་དྲུག་བརྡ་གཅིག་ལ་རྟེན་པའི་ལས་ཀ་བསྐྱར་ཟློས་མ་འགོ་འཛུགས་མི་བྱ།
• ཆེས་ཀེ་མེ་ཏ་དེ་ལ་འབད་རུང་བ་ཉེ་འདོད་འདི་ལ་འགོ་བསྐྱོད་འབད་དགོས་ཡོད། དེ་ལས་འགོ་བསྐྱོད་འབད་ཡོད་པའི་སྐུལ་འདེམས་འདི་ལ་འགོ་བསྐྱོད་འབད་དགོས་ཡོད།
• འབྲེལ་བ་མེད་པའི་སྐར་མ་འབད་རུང་བའི་སྐར་མ་འབད་རུང་བ་ལུ་འབད། 429, 503 དང་བསྐྱར་བཀོད་བྱེད་ཐབས་ཚུ།
• རྒྱལ་སྤྱིའི་མངའ་ཁོངས་ཀྱི་སྤྱི་སྤྱོད་བརྙན་སྒྲ་རྒྱུ་ཆའམ་ཡང་ན་ཁྱེད་རང་ལ་ལྟ་སྤྱོད་བྱེད་ཆོག་པའི་བརྙན་སྒྲ་རྒྱུ་ཆ་ཁོ་ན་སྒྲིག་སྤྱོད་བྱོས། DRM དང་ལྟ་སྤྱོད་ཚད་འཛིན་ལ་བརྒལ་མི་བྱེད།
• རེ་འདུན་ཨང་གྲངས་དང་ལས་ཀའི་ཨང་གྲངས་དག་སྒེར་གྱི་ལག་ལེན་ལོགས་ཀའི་ཉིན་ཐོར་ནང་དུ་ཉར་ཚགས་བྱོས། འབུལ་བཏང་བྱས་པའི URL དག་མི་དགོས་པར་ཉིན་ཐོར་ནང་དུ་མ་འགོད།

YTSave གིས Schema ལ་སྡོད་སྒྲུབ་ཀྱི་དབང་སྐྱོང་ལ་ཐོག་མར་སྐྱེད་སྒོའི་དོན་སྐྱེད་གཏན་འཁེལ་བྱས་ནས་རྟོག་ཞིབ་བྱེད་པ་ཡིན། དེའི་རྗེས་སུ་སྤྲོད་པའི་ར་སྤྲོད་དང་ཡིག་ཆར་བཀོད་པའི་ཞུ་གཏུག་གཟུགས་རྣམས་མཐོང་ནས་བསྲུངས་ཀྱི་ཡོད། OpenAPI འབྲེལ་བའི་རྣམ་ཐར།