ผลิตภัณฑ์ REST API · v1

สร้างการดาวน์โหลดด้วย YTSave

แก้ URL สื่อสาธารณะเลือกรูปแบบที่แน่นอนสร้างงานที่ไม่สม่ำเสมอและมอบผลลัพธ์ที่ลงนามให้กับผู้ใช้ของคุณท่อส่งผลิตภัณฑ์ที่มีขอบเขตเดียวกันเป็นพลังงานให้กับเว็บไซต์ YTSave

YTSaveClientJSON ผ่าน HTTPSงานที่ไม่สม่ำเสมอข้อมูลประจำตัวที่กำหนดขอบเขต
01

การเริ่มต้นอย่างรวดเร็ว

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 แยกการจัดเก็บความลับฝั่งเซิร์ฟเวอร์ออกจากการฝังชุดไคลเอนต์ บันทึกหลักฐานไม่ให้บันทึกสาธารณะหรือที่เก็บข้อมูลมีที่ของตัวเอง

02

แก้ไขปัญหาการเชื่อมโยง

YTSave จัดการการดำเนินการ Resolve โดยเริ่มจากการระบุการตรวจจับแหล่งที่มา ตามด้วยรูปแบบจาก URL ที่ส่งมาเพียงหนึ่งรายการและไม่เก็บผลลัพธ์ที่ประดิษฐ์ขึ้นในมุมมอง

ข้อความ/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 แยกค่าที่ส่งคืนโดยไม่เปลี่ยนแปลงจากความพร้อมใช้งานต่อการเชื่อมโยง บันทึกหลักฐานไม่ให้ป้ายคุณภาพที่คาดเดาได้มีที่ของตัวเอง

03

สร้างและติดตามงานดาวน์โหลด

สำหรับการสร้างงาน YTSave เริ่มต้นด้วยการเตรียมการแบบอะซิงโครนัส บันทึกหลักฐานของมันจับคู่กับคำขอ HTTP สั้น ๆ และจบลงด้วยการดำเนินการของพนักงานที่มีขอบเขตจำกัด

ข้อความ/v1/jobsขอบเขต: งาน
ช่องข้อมูลชนิดต้องการคำอธิบาย
urlที่อยู่ URL แบบ HTTPSใช่เดียวกันแหล่งที่มาปกติยื่นให้แก้ไข
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"}'
1202 รับรองบันทึก@ info job_id.
2สถานะการโหวตGET /v1/jobs/{job_id} ด้วยกุญแจเดียวกัน
3พร้อมเปิด URL ดาวน์โหลดที่เซ็นชื่อ
สถานะความหมายการกระทำของไคลเอนต์
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 ทำให้การตรวจสอบงานง่ายต่อการสแกน หน้าเริ่มต้นด้วยการรอเริ่มต้นหนึ่งวินาที เคลื่อนที่ไปยังการหน่วงเวลาที่จำกัด และระบุการจัดส่งที่ลงนามชั่วคราวอย่างชัดเจน

04

ความผิดพลาดที่คาดการณ์ได้

สำหรับสัญญาข้อผิดพลาด 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": "…"
}
ข้อความความหมายโดยทั่วไปการกระทำ
400URL ไม่ถูกต้อง, ส่วนตัว หรือ รูปแบบที่ไม่สามารถใช้ได้.แก้ไขคำขอ แก้ไขอีกครั้งสำหรับรูปแบบ
401คีย์หายไป ไม่ถูกต้อง หมดอายุ หรือมีขอบเขตไม่ถูกต้องตรวจสอบข้อมูลประจำตัวด้านเซิร์ฟเวอร์
403นโยบายผู้เช่าหรือแหล่งที่มาปฏิเสธคำขออย่าข้ามนโยบาย ติดต่อฝ่ายสนับสนุน
404งานที่ไม่รู้จักหรือหมดอายุแล้วสร้างงานใหม่หากเหมาะสม
429ถึงขีด จำกัด การร้องขอหรืองานที่ทำงานอยู่แล้วเกียรติ retry_after_seconds.
503คิว/ความจุ หรือแหล่งข้อมูลต้นทางไม่พร้อมใช้งานชั่วคราวลองใหม่ด้วย backoff และ jitter แบบเอกซ์โพเนนเชียล
05

สัญญาการดำเนินงาน

YTSave ออกโควตาการดำเนินงานพร้อมกับการอนุมัติแต่ละครั้งเพื่อปกป้องผู้บริโภค API และบริการสื่อล่วงหน้า

YTSave จัดการการเข้าถึง Schema โดยเริ่มจากการระบุการเปิดใช้งานก่อนการสำรวจ ตามด้วยการตรวจสอบสิทธิ์ที่กำหนดไว้และเก็บรูปแบบคำขอบันทึกไว้ในมุมมอง คำอ้างอิง OpenAPI

เข้าถึงที่ตรวจสอบโดยผู้ปฏิบัติงาน

ขอกุญแจ API ของคุณ

บันทึกผู้บริโภค API การประมาณคำขอรายเดือน และข้อกำหนดแพลตฟอร์มที่รองรับ YTSave ตรวจสอบว่าการแก้ไข การส่งงาน หรือทั้งสองอย่างนั้นสมเหตุสมผลก่อนออกกุญแจที่เคยมองเห็นได้ครั้งเดียว

ขอเข้าถึง API กุญแจมีขอบเขตของผู้เช่าสามารถยกเลิกได้และออกโดยผ่านแบบฟอร์มติดต่อสคริปต์นิรนามไม่สามารถประมวลผลงานดาวน์โหลดได้