შექმენით ჩამოტვირთვები 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 ამარტივებს სამუშაოს გამოკითხვას სკანირებისთვის. გვერდი იწყება ერთწამიანი საწყისი მოლოდინით, გადადის შეზღუდულ უკუსვლაზე და მკაფიოდ აცხადებს დროებით ხელმოწერილ მიწოდებას.

{
  "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-ები პირად ოპერაციულ ლოგებში. არ დაარეგისტრიროთ წარდგენილი URL-ები უსარგებლოდ.

YTSave მართავს სქემის წვდომას, პირველ რიგში ამოქმედების იდენტიფიცირებით, შემდეგ მიჰყვება დანიშნულ ავტენტიფიკაციას და ინახავს დოკუმენტირებულ მოთხოვნის ფორმებს ხედვაში. OpenAPI მითითება