https://easyt.ioสร้างการดาวน์โหลดด้วย EasyT
การอ้างอิง EasyT นี้เป็นคู่มือการใช้งาน ไม่ใช่จุดเชื่อมต่อแบบไม่ระบุตัวตนที่ใช้งานจริง การเข้าถึงในสภาพแวดล้อมการผลิตจะเริ่มขึ้นหลังจากฝ่ายสนับสนุนอนุมัติไคลเอนต์และกำหนดขีดจำกัด
การเริ่มต้นอย่างรวดเร็ว
โฮสต์ API เริ่มต้นด้วยข้อมูลรับรองที่เปิดใช้งานการสนับสนุนบน EasyT การตรวจสอบที่แนะนำนี้จะแสดงจุดสิ้นสุดของผู้เช่าแบบกำหนดไว้ ข้อเท็จจริงสุดท้ายคือเส้นทางการเรียกเฉพาะเซิร์ฟเวอร์
X-API-Key: pending_activation_…EasytWorkspacev1# Available only after support activation
export EASYT_WORKSPACE_TOKEN="issued-after-review"
curl -X POST https://easyt.io/v1/resolve \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'ใน EasyT การจัดเก็บความลับฝั่งเซิร์ฟเวอร์เป็นอันดับแรกเมื่ออธิบายความปลอดภัยของข้อมูลรับรอง การตรวจสอบที่แนะนำตามมาด้วยการไม่มีการฝังชุดไคลเอนต์ และปิดท้ายด้วยการไม่มีบันทึกสาธารณะหรือที่เก็บข้อมูล
แก้ไขปัญหาการเชื่อมโยง
การดำเนินการแก้ไขเริ่มต้นด้วยการตรวจจับแหล่งที่มาใน EasyT การตรวจสอบที่แนะนำนี้จะแสดงรูปแบบจาก URL ที่ส่งมาเพียงหนึ่งรายการ ข้อเท็จจริงสุดท้ายคือไม่มีผลลัพธ์ที่ถูกประดิษฐ์ขึ้น
/v1/resolveขอบเขต: แก้ไข| ช่องข้อมูล | ชนิด | ต้องการ | คำอธิบาย |
|---|---|---|---|
input_url | ที่อยู่ URL แบบ HTTPS | ใช่ | หน้าสื่อสาธารณะหรือที่ได้รับอนุญาตให้วิเคราะห์ |
tenant | ข้อความ | ไม่มี | โดเมนผู้เช่าที่ได้รับมอบหมาย โดยปกติจะถูกละเว้น |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}ใน EasyT ค่าที่ส่งกลับโดยไม่เปลี่ยนแปลงจะอยู่ก่อนเมื่ออธิบายตัวระบุรูปแบบ การตรวจสอบที่แนะนำนี้จะตามด้วยการเปิดให้ใช้งานต่อการเชื่อมโยงและปิดท้ายด้วยไม่มีป้ายคุณภาพที่คาดเดาได้
สร้างและติดตามงานดาวน์โหลด
การเตรียมแบบอะซิงโครนัสเป็นจุดเริ่มต้นสำหรับการสร้างงานบน EasyT การตรวจสอบแบบมีคำแนะนำจะแสดงคำขอ HTTP สั้นๆ และอธิบายการดำเนินการของพนักงานที่มีขอบเขตจำกัด
/v1/jobsขอบเขต: งาน| ช่องข้อมูล | ชนิด | ต้องการ | คำอธิบาย |
|---|---|---|---|
input_url | ที่อยู่ URL แบบ HTTPS | ใช่ | เดียวกันแหล่งที่มาปกติยื่นให้แก้ไข |
stream_choice | ข้อความ | ใช่ | หมายเลข ID ที่แน่นอนจากคำตอบการแก้ไข |
tenant | ข้อความ | ไม่มี | โดเมนผู้เช่าที่ได้รับมอบหมาย โดยปกติจะถูกละเว้น |
curl -X POST https://easyt.io/v1/jobs \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID","stream_choice":"18"}'workspace_job.GET /v1/jobs/{workspace_job} ด้วยกุญแจเดียวกัน| สถานะ | ความหมาย | การกระทำของไคลเอนต์ |
|---|---|---|
queued | รับเข้าคิวที่กำหนดขอบเขต | โพลอีกครั้งด้วยการถอยหลัง |
extracting | กำลังรีเฟรชเมตาข้อมูลแหล่งหรือเส้นทาง | ทำการโพลต่อไป |
processing | การดาวน์โหลด รีมูซ หรือการรวม | แสดงความคืบหน้าของเซิร์ฟเวอร์ |
ready | ดาวน์โหลดที่ลงนามมีให้ | ส่ง URL ไปยังผู้ใช้ |
failed | ข้อผิดพลาดของโครงสร้างเทอร์มินัล | อ่านแล้ว error_codeลองใหม่เมื่อได้รับคำแนะนำเท่านั้น |
expired | ผลลัพธ์ชั่วคราวถูกลบออก | สร้างงานใหม่ |
curl https://easyt.io/v1/jobs/WORKSPACE_JOB \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN"สำหรับการตรวจสอบงาน EasyT เริ่มต้นด้วยการรอหนึ่งวินาที การตรวจสอบที่แนะนำจะจับคู่กับการหน่วงเวลาที่จำกัดและสิ้นสุดด้วยการส่งมอบที่ลงชื่อชั่วคราว
ความผิดพลาดที่คาดการณ์ได้
EasyT ทำให้สัญญาข้อผิดพลาดง่ายต่อการสแกน หน้าเริ่มต้นด้วยซองจดหมายที่ไม่ใช่ 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": "…"
}| ข้อความ | ความหมายโดยทั่วไป | การกระทำ |
|---|---|---|
| 400 | URL ไม่ถูกต้อง, ส่วนตัว หรือ รูปแบบที่ไม่สามารถใช้ได้. | แก้ไขคำขอ แก้ไขอีกครั้งสำหรับรูปแบบ |
| 401 | คีย์หายไป ไม่ถูกต้อง หมดอายุ หรือมีขอบเขตไม่ถูกต้อง | ตรวจสอบข้อมูลประจำตัวด้านเซิร์ฟเวอร์ |
| 403 | นโยบายผู้เช่าหรือแหล่งที่มาปฏิเสธคำขอ | อย่าข้ามนโยบาย ติดต่อฝ่ายสนับสนุน |
| 404 | งานที่ไม่รู้จักหรือหมดอายุแล้ว | สร้างงานใหม่หากเหมาะสม |
| 429 | ถึงขีด จำกัด การร้องขอหรืองานที่ทำงานอยู่แล้ว | เกียรติ retry_after_seconds. |
| 503 | คิว/ความจุ หรือแหล่งข้อมูลต้นทางไม่พร้อมใช้งานชั่วคราว | ลองใหม่ด้วย backoff และ jitter แบบเอกซ์โพเนนเชียล |
สัญญาการดำเนินงาน
EasyT เลือกสิทธิ์การใช้งานในระหว่างการตรวจสอบ โดยปรับสมดุลความต้องการของแอปพลิเคชันกับสุขภาพของผู้ให้บริการ
- ใช้ตรรกะการใช้งาน idempotent และไม่เคยเริ่มงานซ้ำสำหรับคลิกเดียวกันของผู้ใช้
- แคชแก้ปัญหาข้อมูลกำกับโดยสั้น ๆ แต่มักจะปฏิบัติต่อ URL ดาวน์โหลดที่ลงนามว่าหมดอายุ
- ใช้ backoff แบบเอกซ์โพเนนเชียลที่มีขอบเขตด้วย jitter สำหรับ
429,503และความผิดพลาดที่สามารถลองใหม่ได้ - ประมวลผลเฉพาะสื่อสาธารณะหรือสื่อที่คุณได้รับอนุญาตให้เข้าถึง DRM และการควบคุมการเข้าถึงไม่ถูกข้าม
- เก็บหมายเลข ID คำขอและหมายเลข ID งานในบันทึกการทำงานส่วนตัว อย่าบันทึก URL ที่ส่งมาโดยไม่จำเป็น
การเข้าถึงสคีมาเริ่มต้นด้วยการเปิดใช้งานก่อนการสำรวจบน EasyT การตรวจสอบที่แนะนำนี้จะแสดงการตรวจสอบสิทธิ์ที่กำหนดไว้ ข้อเท็จจริงสุดท้ายคือรูปแบบคำขอที่บันทึกไว้
กระตุ้นผ่านการสนับสนุน
รวมวัตถุประสงค์ของลูกค้า ปริมาณงานรายเดือนที่คาดหวัง และเครือข่ายที่ร้องขอในบันทึกการเปิดใช้งาน จากนั้น EasyT สามารถเลือกขอบเขตการแก้ไขและงานได้อย่างถูกต้องก่อนสร้างความลับแบบมุมมองเดียว
ขอให้เปิดใช้งาน กุญแจมีขอบเขตของผู้เช่าสามารถยกเลิกได้และออกโดยผ่านแบบฟอร์มติดต่อสคริปต์นิรนามไม่สามารถประมวลผลงานดาวน์โหลดได้