İSTEHSAL REST API · v1

YTSave ilə yükləmələr yaradın

İctimai media URL-sini həll edin, dəqiq format seçin, asinxron iş yaradın və imzalanmış nəticəni istifadəçinizə təqdim edin. Eyni bağlı istehsal boru xətti YTSave veb saytını gücləndirir.

YTSaveClientHTTPS üzərindən JSONAsinxron işlərMəhdudlaşdırılmış etimadnamələr

Tez başlama

YTSave API hostunu əvvəlcə dəstək-aktivləşdirilmiş etimadnamələri müəyyən etməklə idarə edir. Sonra təyin olunmuş tenant endpointi izləyir və yalnız server çağırış yolunu görünür saxlayır.

İcarəçi URLhttps://ytsave.app

DoğrulamaX-API-Key: ys_live_…

Müştəri profiliYTSaveClient

API versiyasıv1

# Available only after support activation
export YTSAVE_API_KEY="issued-after-review"

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

Sertifikat təhlükəsizliyini izah etmək üçün YTSave server tərəfi gizli saxlamanı müştəri paketinə daxil etmədən ayırır. Sübut qeydi heç bir ictimai qeyd və ya anbar üçün öz yerini vermir.

Linki həll et

YTSave Həll əməliyyatını əvvəlcə mənbə aşkarlanmasını müəyyən etməklə idarə edir. Sonra bir təqdim edilmiş URL-dən formatları izləyir və görünüşdə ixtira edilmiş çıxışları saxlamır.

POST/v1/resolveSahə: həll et

Sahə	Növ	Tələb olunur	Təsvir
`url`	HTTPS URL	Bəli	Təhlil üçün ictimai və ya səlahiyyətli media səhifəsi.
`tenant`	sətir	Yox	Təyin edilmiş kirayəçi domeni. Adətən atlanılır.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Format identifikatorunu izah etmək üçün YTSave qaytarılan dəyəri keçid-əsaslı mövcudluqdan dəyişmədən ayırır. Bir sübut qeydi təxmin edilən keyfiyyət etiketinə öz yerini vermir.

Yükləmə işi yarat və izləyin

İş yaradılması üçün YTSave əvvəlcə asinxron hazırlıqla başlayır. Onun sübut qeydi bunu qısa HTTP sorğusu ilə cütləşdirir və məhdud işçi icrası ilə bitir.

POST/v1/jobsSahə: işlər

Sahə	Növ	Tələb olunur	Təsvir
`url`	HTTPS URL	Bəli	Həll etmək üçün təqdim olunan eyni normallaşdırılmış mənbə.
`format_id`	sətir	Bəli	Həll cavabından dəqiq ID.
`tenant`	sətir	Yox	Təyin edilmiş kirayəçi domeni. Adətən atlanılır.

curl -X POST https://ytsave.app/v1/jobs \
  -H "X-API-Key: $YTSAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID","format_id":"18"}'

1202 Qəbul edildiYadda saxla job_id.

2Sorğu vəziyyətiGET /v1/jobs/{job_id} eyni açarla.

3Hazırİmzalanmış yükləmə URL-sini açın.

Vəziyyət	Mənası	Müştəri hərəkəti
`queued`	Məhdud növbəyə qəbul edildi.	Geri çəkilmə ilə yenidən sorğu.
`extracting`	Mənbə metadatası və ya marşrut yenilənir.	Sorğulama davam edir.
`processing`	Yüklənir, remux edilir və ya birləşdirilir.	Serverin irəliləyişini göstər.
`ready`	İmzalanmış yükləmə mövcuddur.	URL-ni istifadəçiyə göndərin.
`failed`	Terminal strukturlaşdırılmış səhv.	Oxu `error_code`. Yalnız məsləhət verildikdə yenidən cəhd edin.
`expired`	Müvəqqəti çıxış silindi.	Yeni iş yaradın.

curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSave İş sorğusunu asanlıqla skan etməyə imkan verir. Səhifə bir saniyəlik ilkin gözləmə ilə başlayır, məhdudlaşdırılmış geri çəkilməyə keçir və müvəqqəti imzalanmış çatdırılmanı açıq şəkildə bildirir.

Gözlənilən səhvlər

Xəta müqaviləsi üçün YTSave dəstək sorğusu ID-dən əvvəl bir qeyri-2xx zərfi yoxlayır. Bu sübut qeydi həmçinin proqnozlaşdırılan müştəri idarəsini aydın edir.

{
  "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": "…"
}

HTTP	Tipik mənası	Hərəkət
400	Yanlış URL, məzmun və ya mövcud olmayan format.	Sorğunu düzəldin. Formatlar üçün yenidən həll edin.
401	Əskik, etibarsız, müddəti bitmiş və ya səhv əhatəli açar.	Server tərəfi etimadnaməsini yoxlayın.
403	Kirayəçi və ya mənbə siyasəti sorğunu rədd etdi.	Siyasəti keçməyin. Dəstək ilə əlaqə saxlayın.
404	Naməlum və ya müddəti bitmiş iş.	Əgər uyğun olarsa, yeni iş yaradın.
429	Sorğu və ya aktiv iş limiti çatıb.	Şərəf `retry_after_seconds`.
503	Növbə/tutum və ya yuxarı axın müvəqqəti olaraq mövcud deyil.	Eksponensial geri çəkilmə və səs-küy ilə yenidən cəhd edin.

Əməliyyat müqaviləsi

YTSave API istifadəçisini və yuxarı axın media xidmətlərini qorumaq üçün hər təsdiqləmə ilə əməliyyat kvotası verir.

İdempotent tətbiq məntiqindən istifadə edin və eyni istifadəçi klik üçün heç vaxt təkrarlanan işlərə başlamayın.
Keş metadatasını qısa müddətə həll edin, lakin imzalanmış yükləmə URL-lərini həmişə müddəti bitmiş kimi qəbul edin.
Üçün sərhədlənmiş eksponensial geri çəkilməni jitter ilə istifadə edin 429, 503 və təkrar cəhd edilə bilən səhvlər.
Yalnız ictimai media və ya daxil olmaq üçün icazəniz olan medianı işləyin. DRM və giriş nəzarətləri keçilməzdir.
Sorğu ID-lərini və iş ID-lərini şəxsi əməliyyat qeydlərində saxlayın. Göndərilən URL-ləri lazımsız qeyd etməyin.

YTSave Schema girişini əvvəlcə aktivləşdirməni müəyyən etməklə idarə edir, sonra təyin edilmiş autentifikasiyanı izləyir və sənədləşdirilmiş sorğu formalarını görünüşdə saxlayır. OpenAPI istinadı

OPERATOR TƏRƏFİNDƏN YOXLANMIŞ GİRİŞ

API açarınızı tələb edin

API istifadəçisini, onun aylıq sorğu təxminini və dəstəklənən platforma tələblərini sənədləşdirin. YTSave bir dəfə görünən açar verməzdən əvvəl həll, iş təqdimatı və ya hər ikisinin əsaslı olub-olmadığını nəzərdən keçirir.

API girişini tələb et Açarlar tenant səviyyəsindədir, geri çağırıla bilər və Əlaqə forması vasitəsilə verilir. Anonim skriptlər yükləyici işini icra edə bilməz.