REST API

העלה ושתף קבצים

מדריך זה לוקח קובץ מקומי אחד בשם demo.mp4 והופך אותו לשיתוף עבודה URL. השלם את השלבים לפי הסדר; כל תגובה מספקת ערך המשמש לבקשה הבאה.

צור ושמור מפתח API

פתח את הגדרות המפתחים, בחר העלאות:כתוב, קבצים:קריאה, שיתופים:כתיבה ושיתופים:קריאה, ולאחר מכן צור את המפתח. העתק אותו עכשיו - הסוד המלא מוצג פעם אחת בלבד.

היקפים זמינים: uploads:write, files:read, shares:write, and shares:read.

תוצאה צפויה:יש לך סוד שמתחיל בקידומת המפתח Video2URL. שמור את זה בפרטי.

הכן את הטרמינל שלך

שים את המפתח במשתנה סביבה כך שהוא לא יופיע בכל פקודה או בהיסטוריית המעטפת שלך. החלף את מציין המיקום לפני הקשה על Enter.

Terminal

read -s VIDEO2URL_API_KEY
echo "key loaded"

תוצאה צפויה:הפקודה מדפיסה מפתח טעון, לא את הסוד עצמו.

צור עבודת העלאה

אמור לVideo2URL את שם הקובץ המדויק, סוג MIME וגודל הבתים. זה מחזיר העלאה זמנית R2 URL; זה עדיין לא מעלה את הסרטון.

POST /api/v1/uploads

curl

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}'

תוצאה צפויה:תגובת JSON המכילה data.uploadId ו-data.upload.url. שמור את שני הערכים לשלבים הבאים.

Save response values

export UPLOAD_ID="paste data.uploadId here"
export UPLOAD_URL="paste data.upload.url here"

שלח את הווידאו בייטים

העלה הדגמה.mp4 ישירות ל-URL הזמני. אל תוסיף את מפתח ה-API Video2URL לבקשת PUT זו. השתמש ב-Content-Type שהוחזר על ידי תגובת היצירה להעלאה. העלה את הקובץ הגולמי ל-URL המוגדר מראש באמצעות סוג התוכן המוחזר.

curl · PUT

curl --fail-with-body -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  --data-binary @demo.mp4

תוצאה צפויה:שרת ההעלאה מחזיר HTTP 200. גוף תגובה ריק הוא תקין.

השלם ואמת את ההעלאה

לאחר שה-PUT הצליח, אמור ל-Video2URL לאמת את האובייקט המאוחסן וליצור את רשומת הקובץ. אל תקרא לשלב זה לפני שה-PUT מסתיים.

POST /api/v1/uploads/{uploadId}/complete · GET /api/v1/uploads/{uploadId}

curl

curl -sS -X POST "https://video2url.com/api/v1/uploads/$UPLOAD_ID/complete" \
  -H "Authorization: Bearer $VIDEO2URL_API_KEY"

תוצאה צפויה:התגובה מכילה data.file.fileId. שמור FILE_ID; זה מזהה את הקובץ שהושלם.

Save FILE_ID

export FILE_ID="paste data.file.fileId here"

צור את השיתוף הסופי URL

צור קישור לא רשום מ-FILE_ID. לא רשום פירושו שכל אחד עם URL יכול לפתוח אותו, אבל הוא לא ממוקם בספרייה ציבורית.

הכותרת היא אופציונלית.
הסיסמה היא אופציונלית.
הנראות היא אופציונלית.
ברירת המחדל של הנראות היא לא רשום.

POST /api/v1/shares · GET / DELETE /api/v1/shares/{shareId}

curl

curl -sS -X POST https://video2url.com/api/v1/shares \
  -H "Authorization: Bearer $VIDEO2URL_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{"fileId":"$FILE_ID","visibility":"unlisted"}"

תוצאה צפויה:התגובה מכילה את רשומת השיתוף ואת URL. פתח את SHARE_URL בחלון דפדפן פרטי כדי לאמת זאת.

Open SHARE_URL

export SHARE_URL="paste the returned share URL here"
open "$SHARE_URL" # macOS; use xdg-open on Linux

JavaScript & Python

צור את המפתח הצר ביותר שאתה צריך. סובב על ידי יצירה ופריסה של תחליף לפני ביטול המפתח הישן. אם הגישה בתשלום מסתיימת, המפתחות נשארים שמורים אך השיחות מושהות; חידוש תוכנית זכאית משחזר את הגישה.

JavaScript

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();

Python

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:
    requests.put(created.json()["data"]["upload"]["url"], data=video).raise_for_status()