ดูตัวอย่างเท่านั้น — ต้องการการเปิดใช้งาน

สร้างการดาวน์โหลดด้วย downf.io

DownF รักษาการปิดใช้งานการดำเนินการ API จนกว่าผู้ปฏิบัติงานจะตรวจสอบกรณีการใช้งานความเข้ากันได้ ตัวอย่างอธิบายสัญญาที่วางแผนไว้ ในขณะที่ข้อมูลรับรองและโควต้าจริงจะมาถึงผ่านการเปิดใช้งานการสนับสนุนเท่านั้น

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

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

DownF จัดระเบียบโฮสต์ API รอบๆ ข้อมูลประจำตัวที่เปิดใช้งานโดยการสนับสนุน มุมมองความเข้ากันได้นี้เปรียบเทียบจุดสิ้นสุดของผู้เช่าเฉพาะ เส้นทางการเรียกใช้เฉพาะเซิร์ฟเวอร์ยังคงเป็นการตรวจสอบขั้นสุดท้าย

ที่อยู่ URL ของผู้เช่าhttps://downf.io
การตรวจสอบสิทธิ์X-API-Key: pending_activation_…
โปรไฟล์ของลูกค้าDownfBridge
รุ่นของ APIv1
# Available only after support activation
export DOWNF_ACCESS_TOKEN="issued-after-review"

curl -X POST https://downf.io/v1/resolve \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID"}'

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

02

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

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

ข้อความ/v1/resolveขอบเขต: แก้ไข
ช่องข้อมูลชนิดต้องการคำอธิบาย
media_addressที่อยู่ URL แบบ HTTPSใช่หน้าสื่อสาธารณะหรือที่ได้รับอนุญาตให้วิเคราะห์
tenantข้อความไม่มีโดเมนผู้เช่าที่ได้รับมอบหมาย โดยปกติจะถูกละเว้น
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

ตัวระบุรูปแบบเริ่มต้นด้วยค่าที่ส่งกลับโดยไม่เปลี่ยนแปลงบน DownF มุมมองความเข้ากันได้นี้จะแสดงความพร้อมใช้งานต่อแต่ละลิงก์ ข้อเท็จจริงสุดท้ายคือไม่มีป้ายคุณภาพที่คาดเดาได้

03

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

การสร้างงานเริ่มต้นด้วยการเตรียมการแบบ asynchronous บน DownF มุมมองถัดไปครอบคลุมการร้องขอ HTTP แบบสั้น ๆ หน้านี้รักษาการประมวลผลของผู้ทำงานที่มีขอบเขตให้เห็นได้

ข้อความ/v1/jobsขอบเขต: งาน
ช่องข้อมูลชนิดต้องการคำอธิบาย
media_addressที่อยู่ URL แบบ HTTPSใช่เดียวกันแหล่งที่มาปกติยื่นให้แก้ไข
output_refข้อความใช่หมายเลข ID ที่แน่นอนจากคำตอบการแก้ไข
tenantข้อความไม่มีโดเมนผู้เช่าที่ได้รับมอบหมาย โดยปกติจะถูกละเว้น
curl -X POST https://downf.io/v1/jobs \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'
1202 รับรองบันทึก@ info transfer_ref.
2สถานะการโหวตGET /v1/jobs/{transfer_ref} ด้วยกุญแจเดียวกัน
3พร้อมเปิด URL ดาวน์โหลดที่เซ็นชื่อ
สถานะความหมายการกระทำของไคลเอนต์
queuedรับเข้าคิวที่กำหนดขอบเขตโพลอีกครั้งด้วยการถอยหลัง
extractingกำลังรีเฟรชเมตาข้อมูลแหล่งหรือเส้นทางทำการโพลต่อไป
processingการดาวน์โหลด รีมูซ หรือการรวมแสดงความคืบหน้าของเซิร์ฟเวอร์
readyดาวน์โหลดที่ลงนามมีให้ส่ง URL ไปยังผู้ใช้
failedข้อผิดพลาดของโครงสร้างเทอร์มินัลอ่านแล้ว error_codeลองใหม่เมื่อได้รับคำแนะนำเท่านั้น
expiredผลลัพธ์ชั่วคราวถูกลบออกสร้างงานใหม่
curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

มุมมองความเข้ากันได้ของ DownF ตรวจสอบการรอคอยในเบื้องต้นหนึ่งวินาทีสำหรับการโพลล์งาน มันแสดงให้เห็นถึง backoff ที่ปิดกั้นต่อไปและไม่ทำให้มืดมนการส่งมอบที่เซ็นชื่อชั่วคราว

04

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

DownF นำเสนอสามประเด็นที่ใช้งานได้จริงสำหรับสัญญาผิดพลาด ข้อแรกคือซองจดหมายที่ไม่ใช่ 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

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

DownF จัดสรรเพดานคำขอหลังจากตรวจสอบลูกค้าที่ตั้งใจไว้, รักษาการตรวจสอบความเข้ากันได้ของมันและผู้ให้บริการขั้นสูงให้มีความมั่นคง

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

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

กระตุ้นผ่านการสนับสนุน

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

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