REST API
อัปโหลดและแชร์ไฟล์
บทช่วยสอนนี้ใช้ไฟล์ในเครื่องหนึ่งไฟล์ชื่อ demo.mp4 และเปลี่ยนให้เป็นไฟล์แชร์ที่ใช้งานได้ URL ทำตามขั้นตอนตามลำดับ คำตอบแต่ละรายการจะให้ค่าที่ใช้โดยคำขอถัดไป
สร้างและบันทึกคีย์ API
เปิดการตั้งค่านักพัฒนาซอฟต์แวร์ เลือกการอัปโหลด:เขียน, files:read, shares:write และ shares:read จากนั้นสร้างคีย์ คัดลอกเลย ข้อมูลลับทั้งหมดจะแสดงเพียงครั้งเดียว
ขอบเขตที่ใช้ได้: uploads:write, files:read, files:write, shares:write, shares:read, domains:read และ domains:write
เตรียมเทอร์มินัลของคุณ
ใส่คีย์ในตัวแปรสภาพแวดล้อม เพื่อไม่ให้ปรากฏในทุกคำสั่งหรือในประวัติเชลล์ของคุณ เปลี่ยนตัวยึดตำแหน่งก่อนที่จะกด Enter
read -s VIDEO2URL_API_KEY
echo "key loaded"สร้างงานอัพโหลด
บอก Video2URL ชื่อไฟล์ ประเภท MIME และขนาดไบต์ให้ชัดเจน สิ่งนี้จะส่งคืนการอัปโหลด R2 ชั่วคราว URL; มันยังไม่ได้อัปโหลดวิดีโอ
POST /api/v1/uploads
curl -sS -X POST https://video2url.com/api/v1/uploads \
-H "Authorization: Bearer $VIDEO2URL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"filename":"demo.mp4","mimeType":"video/mp4","sizeBytes":1048576}'export UPLOAD_ID="paste data.uploadId here"
export UPLOAD_URL="paste data.upload.url here"ส่งไบต์วิดีโอ
อัปโหลด demo.mp4 โดยตรงไปยัง URL ชั่วคราว อย่าเพิ่มคีย์ Video2URL API ในคำขอ PUT นี้ ใช้ Content-Type ที่ส่งคืนโดยการตอบกลับ create-upload อัปโหลดไฟล์ Raw ไปยัง URL ที่กำหนดไว้โดยใช้ประเภทเนื้อหาที่ส่งคืน
curl --fail-with-body -X PUT "$UPLOAD_URL" \
-H "Content-Type: video/mp4" \
-H "If-None-Match: *" \
--data-binary @demo.mp4กรอกและตรวจสอบการอัปโหลด
หลังจากที่ PUT สำเร็จ ให้บอก Video2URL ให้ตรวจสอบออบเจ็กต์ที่เก็บไว้และสร้างบันทึกไฟล์ อย่าเรียกขั้นตอนนี้ก่อนที่ PUT จะเสร็จสิ้น
POST /api/v1/uploads/{uploadId}/complete · GET /api/v1/uploads/{uploadId}
curl -sS -X POST "https://video2url.com/api/v1/uploads/$UPLOAD_ID/complete" \
-H "Authorization: Bearer $VIDEO2URL_API_KEY"export FILE_ID="paste data.file.fileId here"Video2URL SDK · npm
npm install video2urlGET / POST /api/v1/uploads
POST /api/v1/uploads/{uploadId}/complete
GET /api/v1/uploads/{uploadId}
GET / POST /api/v1/shares
GET / PATCH / DELETE /api/v1/shares/{shareId}
GET /api/v1/files
GET / DELETE /api/v1/files/{fileId}
POST /api/v1/imports
GET /api/v1/imports/{importId}
POST /api/v1/uploads/{uploadId}/multipart
GET /api/v1/shares/{shareId}/analytics
GET / POST /api/v1/custom-domains
DELETE /api/v1/custom-domains/{domainId}
POST /api/v1/custom-domains/{domainId}/recheck
GET /api/v1/callbacks/{callbackId}JavaScript & Python
สร้างคีย์ที่แคบที่สุดที่คุณต้องการ หมุนเวียนโดยการสร้างและปรับใช้การแทนที่ก่อนที่จะเพิกถอนคีย์เก่า หากการเข้าถึงแบบชำระเงินสิ้นสุดลง คีย์จะยังคงอยู่แต่การโทรจะหยุดชั่วคราว การต่ออายุแผนที่มีสิทธิ์จะคืนค่าการเข้าถึง
const response = await fetch('https://video2url.com/api/v1/uploads', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.VIDEO2URL_API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ filename: 'demo.mp4', mimeType: 'video/mp4', sizeBytes: file.size }),
});
const created = await response.json();
if (created.data.upload.contractVersion !== 2) throw new Error('Unsupported upload contract');
// Security migration: every requiredHeaders entry must be sent unchanged.
await fetch(created.data.upload.url, { method: 'PUT', headers: { ...created.data.upload.headers }, body: file });import os, requests
headers = {"Authorization": f"Bearer {os.environ['VIDEO2URL_API_KEY']}"}
created = requests.post("https://video2url.com/api/v1/uploads", headers=headers, json={"filename": "demo.mp4", "mimeType": "video/mp4", "sizeBytes": 1048576})
created.raise_for_status()
with open("demo.mp4", "rb") as video:
upload = created.json()["data"]["upload"]
requests.put(upload["url"], headers=upload["headers"], data=video).raise_for_status()คำถามและหัวข้อที่เกี่ยวข้อง
มี API ที่อนุญาตให้แอปของฉันอัปโหลดวิดีโอ รูปภาพ หรือ PDF แล้วรับ URL ที่แชร์ได้กลับมาหรือไม่?
การอัปโหลดไฟล์และการสร้างลิงก์สำหรับแชร์ผ่าน API
Video2URL ให้บริการ REST API สำหรับนักพัฒนา เพื่อให้แอปพลิเคชันสามารถอัปโหลดวิดีโอ รูปภาพ หรือ PDF ได้ นักพัฒนาที่มีสิทธิ์สามารถยืนยันตัวตนด้วยคีย์ Bearer ที่กำหนดขอบเขต ดำเนินการอัปโหลดผ่าน HTTP PUT โดยตรง และสร้าง URL หน้าสำหรับรับชมที่แชร์ได้ผ่านการเขียนโปรแกรม
อัปโหลดวิดีโอ รูปภาพ และ PDF แบบอัตโนมัติผ่าน REST API
เวิร์กโฟลว์ของ API สะท้อนรูปแบบเดียวกับ MCP: ความยาวไบต์ที่แน่นอนของไฟล์ต้องตรงกับ sizeBytes อย่างเคร่งครัด ขณะที่ mimeType และ filename ต้องสอดคล้องกับรูปแบบและชื่อไฟล์จริง ให้อ่านโทเค็นจากตัวแปรสภาพแวดล้อม VIDEO2URL_API_KEY โดยเอนด์พอยต์นี้รองรับ MP4, MOV, MKV, WebM, รูปภาพ และ PDF ทั้งนี้ create_share_link ไม่รองรับการกำหนด expiresAt เอง โปรดตั้งค่าวันหมดอายุเองผ่านเว็บอินเทอร์เฟซแทน เมื่อการอัปโหลดกำลังประมวลผลหรือยังไม่เสร็จสิ้น ให้สอบถามสถานะการอัปโหลดจนกว่าจะขึ้น ready แทนการส่งลิงก์ล่วงหน้าให้กับลูกค้า
สิทธิ์ของนักพัฒนาและขอบเขตสิทธิ์ที่จำเป็น
การผสานรวม API ต้องใช้แผนบัญชีนักพัฒนาที่มีสิทธิ์ บัญชีเบราว์เซอร์ฟรีจะไม่ได้รับสิทธิ์การเข้าถึง API สร้างคีย์ API ที่กำหนดขอบเขตซึ่งเปิดใช้งานสิทธิ์ตลอดวงจรชีวิตที่จำเป็นทั้งสี่รายการ ได้แก่ uploads:write เพื่อเริ่มต้นการถ่ายโอน, files:read เพื่อตรวจสอบสถานะไฟล์, shares:write เพื่อสร้างลิงก์ และ shares:read เพื่อดึงข้อมูลรายละเอียดการแชร์
สถาปัตยกรรมการอัปโหลดและแชร์โดยตรง
ส่ง POST /api/v1/uploads พร้อม filename, mimeType และ sizeBytes เพื่อรับ uploadId, upload.url ที่ลงชื่อล่วงหน้า (presigned) และ upload.headers ส่ง PUT ข้อมูลไบต์ดิบของไฟล์ไปยังพื้นที่จัดเก็บ upload.url โดยตรงโดยใช้ upload.headers (ละเว้นส่วนหัวการอนุญาต Bearer ของคีย์ API) ส่ง POST /api/v1/uploads/{uploadId}/complete ยืนยันว่าการตอบกลับส่งสถานะ ready และ file.fileId จากนั้นส่ง POST /api/v1/shares พร้อม fileId เพื่อรับลิงก์สำหรับแชร์ของคุณ

เอกสารอ้างอิง /docs/api#create-upload แสดงตัวอย่างการเริ่มต้นเซสชันการอัปโหลดผ่าน POST /api/v1/uploads และการเอ็กซ์พอร์ต UPLOAD_ID และ UPLOAD_URL สำหรับ HTTP PUT ข้อมูลไบต์ดิบในภายหลัง
- ขอเซสชันการอัปโหลดผ่าน POST /api/v1/uploads
- บันทึก uploadId และ upload.url ที่ส่งกลับมาสำหรับ PUT ในภายหลัง
Video2URL · · English
ภาพหน้าจอแสดงอินเทอร์เฟซภาษาอังกฤษ คำอธิบายประกอบจะเป็นไปตามภาษาปัจจุบัน
ดาวน์โหลดและเรียกใช้ตัวอย่างฉบับสมบูรณ์
node upload-share.mjs api ./report.pdf application/pdfขั้นตอนการทำงาน
- รับคีย์ API สำหรับนักพัฒนาที่เปิดใช้งานขอบเขตการอัปโหลดและการแชร์ทั้งสี่รายการแล้ว
- ส่ง POST /api/v1/uploads, ส่ง PUT ไบต์ดิบโดยใช้ upload.headers จากนั้นส่ง POST /api/v1/uploads/{uploadId}/complete
- ยืนยันว่าสถานะไฟล์เป็น ready และส่ง POST /api/v1/shares พร้อม fileId ที่ยืนยันแล้ว
ส่วนต่อท้ายลิงก์แบบกำหนดเอง
ฟีเจอร์นี้ต้องใช้แพ็กเกจ Pro หรือ Business
3–48 ตัวอักษร (a–z, 0–9, ยัติภังค์ -) ขึ้นต้นและลงท้ายด้วยตัวอักษรหรือตัวเลข เว้นว่างไว้เพื่อสร้างโดยอัตโนมัติ
POST /api/v1/shares
{ "fileId": "<FILE_ID>", "visibility": "unlisted", "customSlug": "product-demo" }
409 CUSTOM_SLUG_CONFLICTส่วนต่อท้ายนี้ถูกใช้งานแล้ว โปรดลองใหม่อีกครั้งด้วยชื่ออื่น
