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
}

Format identifier ގެ ބަޔާންކޮށްދޭން، YTSave އިން އިލާވެރިކޮށް ލިބޭ އަގު ބަދަލުންނެއްނުލައި ކޮންމެ link އެއްގެ availability އިން ވަކިކޮށްދޭ. evidence record އެއްގައި ހިޔާލުކޮށް ބައިލާފައިވާ quality label އަކަށް ވަކި ތަނެއް ނެތެވެ.

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 ސްކޭން ކުރުމަށް އަސޭބު ކޮށްދޭ. ޕޭޖުގައި 1 ސިކުންތުގެ ފުރަތަމަ ވެއިޓް އިން ފެށިގެން، ކެޕް ކުރިއްޖަސް 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": "…"
}

• އިޑެމްޕޮޓަންޓް އެޕްލިކޭޝަން ލޮޖިކް ބޭނުންކޮށް, އަދި އެއް ޔޫޒަރު ކްލިކްއަކަށް ދެތަން ޖޮބް ފަށައިގެން ނުދާށެ.
• ކޭޝް ރިސޯލްވް މެޓާޑޭޓާ ބްރިފްލީ، އަދި ސައިންޑް ޑައުންލޯޑް URLތައް އެކްސްޕައިރިންގް އެއްޗެއް ނުކުރަންވީ.
• ބައްލަވާ އެކްސްޕޯނެންޝަލް ބެކްއޮފް އިން ޖިޓްޓަރް އަދި ބައިވެއްޖެ 429, 503 އަދި އަދި ރިޓްރައިއެބަލް އެރަރސް.
• އާންމު މީޑިއާ ނުވަތަ އަދި އެކަން ހައްގުލިބޭނެ މީޑިއާ އަށް ފަހު މާކިޓުކޮށް ފޮލޯކޮށްފައި ހުރި މީޑިއާ އެކަނި ދައްކާ. DRM އަދި އެކްސެސް ކޮންޓްރޯލްސް ބައިޕާސް ނުކުރެވޭ.
• ރައްކާތެރި އޮޕަރޭޝަނަލް ލޮގުތަކުގައި ރިކުއެސްޓް ID ތަކާއި ޖޮބް ID ތައް ބަލައިނުލާ ބައިވެރިކޮށް ހިފާށެވެ. ހުށަހަޅާފައިވާ ޔޫއާރްއެލްތައް ބޭކާރުކޮށް ލޮގުނުކުރާށެވެ.

YTSave އިން Schema އަށް access ހޯއްދަވައި، ކޮންމެވެސް exploration އަށް ފެށޭނީ activation ކަނޑައިގެންނެވެ. އޭގެ ފަހުން assigned authentication އާއިއެކު ދެމިހުންނައެވެ އަދި documented request shapes ދުށްވައި ބަލައިގަނެއެވެ. OpenAPI ރިފެރެންސް