توثيق واجهة برمجة التطبيقات

لمعرفة أسعار واجهة برمجة التطبيقات انقر هنا

يتم استضافة Yout.com API على dvr.yout.com .

المصادقة

للوصول إلى واجهة برمجة تطبيقات Yout.com، يجب عليك تضمين مفتاح API الفريد الخاص بك. يمكنك الحصول على مفتاح API من خلال التسجيل باستخدام عنوان بريدك الإلكتروني. يرجى تذكر الحفاظ على سرية مفتاح API الخاص بك.

يتم التعامل مع المصادقة باستخدام واجهة برمجة التطبيقات من خلال رؤوس HTTP. تتطلب جميع الطلبات رأس تفويض يحتوي على مفتاح واجهة برمجة التطبيقات الخاص بك بتنسيق المفتاح: YOUR_API_KEY ، حيث YOUR_API_KEY هو المفتاح المتوفر على صفحة حسابك.

لأسباب أمنية، يجب إرسال جميع الطلبات عبر اتصال HTTPS مشفر لحماية بياناتك أثناء النقل.

تحويل تنسيق MP3

أرسل رابط الفيديو/الصوت إلى واجهة برمجة تطبيقات Yout.com لتحويل تنسيق MP3. ستكتشف واجهة برمجة التطبيقات تلقائيًا الصوت/الفيديو وتجهزه للتشغيل الأمثل على أجهزة مختلفة.

مثال على تحويل تنسيق MP3

استبدل YOUR_API_KEY بمفتاح API الفريد الخاص بك (الموجود على صفحة حسابك على Yout.com) واستبدل AUDIO_URL بعنوان URL الخاص بالصوت/الفيديو:

import requests
import base64

headers = {"Authorization": "API_KEY"}
audio_url = base64.b64encode("AUDIO_URL")
r = requests.post(
    url="http://dvr.yout.com/mp3",
    headers=headers,
    data={
        "video_url": audio_url,
        "start_time": False,
        "end_time": False,
        "title": "Hello world",
        "artist": "Hello world",
        "audio_quality": '128k',
    }
)

with open("audio.mp3" "wb") as fd:
    for chunk in r.iter_content(chunk_size=128):
        fd.write(chunk)

const axios = require('axios');

const headers = {
  Authorization: "API_KEY"
};

const audioUrl = Buffer.from("AUDIO_URL").toString('base64');

const data = {
  video_url: audioUrl,
  start_time: false,
  end_time: false,
  title: "Hello world",
  artist: "Hello world",
  audio_quality: "128k"
};

axios
  .post("http://dvr.yout.com/mp3", data, { headers })
  .then(response => {
    const fs = require('fs');
    const fileStream = fs.createWriteStream("audio.mp3");

    response.data.pipe(fileStream);

    fileStream.on('finish', () => {
      console.log("Archivo descargado con éxito como audio.mp3");
    });

    fileStream.on('error', error => {
      console.error("Error al escribir el archivo:", error);
    });
  })
  .catch(error => {
    console.error("Error en la solicitud:", error);
  });

<?php
$audio_url = base64_encode("AUDIO_URL");

// Datos para enviar en la solicitud POST
$data = [
    "video_url" => $audio_url,
    "start_time" => false,
    "end_time" => false,
    "title" => "Hello world",
    "artist" => "Hello world",
    "audio_quality" => "128k"
];

// Convertir los datos a formato URL-encoded
$postData = http_build_query($data);

// Configurar la solicitud cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://dvr.yout.com/mp3");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: API_KEY",
    "Content-Type: application/x-www-form-urlencoded"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Ejecutar la solicitud
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    // Guardar el archivo de audio
    $file = fopen("audio.mp3", "wb");
    fwrite($file, $response);
    fclose($file);
    echo "Archivo descargado con éxito como audio.mp3";
} else {
    echo "Error en la solicitud. Código HTTP: $httpCode";
}
?>

curl -X POST "http://dvr.yout.com/mp3" \
         -H "Authorization: API_KEY" \
         -H "Content-Type: application/x-www-form-urlencoded" \
         -d "video_url=$(echo -n 'AUDIO_URL' | base64)" \
         -d "start_time=false" \
         -d "end_time=false" \
         -d "title=Hello world" \
         -d "artist=Hello world" \
         -d "audio_quality=128k" \
         --output audio.mp3

تحويل صيغة MP4

أرسل رابط الفيديو/الصوت إلى واجهة برمجة تطبيقات Yout.com لتحويل تنسيق MP4. ستكتشف واجهة برمجة التطبيقات تلقائيًا الصوت/الفيديو وتجهزه للتشغيل الأمثل على أجهزة مختلفة.

مثال على تحويل تنسيق MP4

استبدل YOUR_API_KEY بمفتاح API الفريد الخاص بك (الموجود على صفحة حسابك على Yout.com) واستبدل VIDEO_URL بعنوان URL الخاص بالصوت/الفيديو:

import requests
import base64

headers = {"Authorization": "API_KEY"}
video_url = base64.b64encode("VIDEO_URL")
r = requests.post(
    url="http://dvr.yout.com/mp4",
    headers=headers,
    data={
        "video_url": video_url,
        "start_time": False,
        "end_time": False,
        "title": "hello world",
        "video_quality": 720
    }
)

with open("audio.mp4" "wb") as fd:
    for chunk in r.iter_content(chunk_size=128):
        fd.write(chunk)

const axios = require('axios');

const headers = {
  Authorization: "API_KEY"
};

const audioUrl = Buffer.from("AUDIO_URL").toString('base64');

const data = {
  video_url: video_url,
  start_time: false,
  end_time: false,
  title" "hello world",
  video_quality: 720
};

axios
  .post("http://dvr.yout.com/mp3", data, { headers })
  .then(response => {
    const fs = require('fs');
    const fileStream = fs.createWriteStream("audio.mp3");

    response.data.pipe(fileStream);

    fileStream.on('finish', () => {
      console.log("Archivo descargado con éxito como audio.mp3");
    });

    fileStream.on('error', error => {
      console.error("Error al escribir el archivo:", error);
    });
  })
  .catch(error => {
    console.error("Error en la solicitud:", error);
  });

<?php
$video_url = base64_encode("VIDEO_URL");

$data = [
    "video_url" => $video_url,
    "start_time" => false,
    "end_time" => false,
    "title" => "hello world",
    "video_quality" => 720
];

$postData = http_build_query($data);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://dvr.yout.com/mp4");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: API_KEY",
    "Content-Type: application/x-www-form-urlencoded"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $file = fopen("video.mp4", "wb");
    fwrite($file, $response);
    fclose($file);
    echo "Archivo descargado con éxito como video.mp4";
} else {
    echo "Error en la solicitud. Código HTTP: $httpCode";
}
?>

curl -X POST "http://dvr.yout.com/mp4" \
     -H "Authorization: API_KEY" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "video_url=$(echo -n 'VIDEO_URL' | base64)" \
     -d "start_time=false" \
     -d "end_time=false" \
     -d "title=hello world" \
     -d "video_quality=720" \
     --output video.mp4

Glossary of parameters

video_url

string (required)

رابط الصوت والفيديو بتنسيق base64. تحقق من جميع الصفحات التي ندعمها. انقر هنا

start_time

int

يُستخدم هذا لقص الصوت أو الفيديو ويمثل الثانية التي تريد أن يبدأ عندها تسجيل الصوت/الفيديو. يمكنك إرسال false للإشارة إلى أنه يجب أن يبدأ من الثانية 0.

end_time

int / bool (false)

يُستخدم هذا لقص الصوت أو الفيديو ويمثل الثانية التي تريد أن ينتهي عندها تسجيل الصوت/الفيديو. يمكنك إرسال <code>false</code> إذا كنت لا تريد قص الصوت/الفيديو.

title

string (required)

العنوان الذي سيتم تسجيل الصوت/الفيديو تحته؛ ويُستخدم أيضًا لتسمية الملف الناتج.

artist

string

اسم الفنان الذي سيتم تسجيل الملف تحته.

audio_quality

string

الجودة التي سيتم تسجيل ملف الصوت بها. الجودة المتاحة هي 32k بايت، 64k ، 128k ، أو 256k ، أو 320k .

video_quality

string

الجودة التي سيتم تسجيل ملف الفيديو بها. الجودة المتاحة هي 144 ، 240 ، 360 ، 480 ، 720 (لـ HD)، 1080 (لـ UHD)، 2160 (لـ 4k)، أو 4320 (لـ 8k).