פּראָדוקציע REST API · v1

בויען אראפקאפיעס מיט YTSave

לייז אַ פּובליק מידיאַ URL, קלייַבן אַ פּינטלעך פֿאָרמאַט, שאַפֿן אַן־סינכְראָנישן אַרבעט און געבן דעם אונטערשריבן רעזולטאַט צו דיין באַניצער. דער זעלביקער באַגרענעצטער פּראָדוקציע־פּייפּליין מאַכט די YTSave וועבזייטל.

YTSaveClientJSON איבער HTTPSאַסינכראָנישע אַרבעטגעשפּרייטע קרעדענציעלן
01

פֿאַסט אָנהייב

YTSave האַנדלט API האָסט דורך ערשטער אידענטיפיצירן שטיצע-אַקטיוויטעטן קרעדענציעלן. עס נאָכגייט מיט אַ צוגעווייזט טענאַנט ענדפּונקט און הält אַ סערווער-נור רוף וועג אין זעאונג.

טענאַנט URLhttps://ytsave.app
אוטענטיפֿיקאַציעX-API-Key: ys_live_…
קליענט פּראָפילYTSaveClient
API ווערסיע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"}'

צו דערקלערן קרעדענציעל זיכערהייט, טרענט YTSave סערווער-זייט סעקרט סטאָרידזש פֿון קיין קליענט באַנדל עמבעדינג. אַן עדות רעקאָרד גיט קיין פּובליק לאָגס אָדער רעפּאַזיטאָריעס זײַן אייגענע אָרט.

02

לייזן אַ לינק

YTSave האַנדלס ריזאָלוו אָפּעראַציע דורך ערשטער אידענטיפיצירן מקור דיטעקשאַן. עס נאָכגייט מיט פֿאָרמאַטן פון איין אַרײַנגעלייגט URL און הält קיין אויסגעדאַכט אויסגאַנג אין מיינונג.

פּאָסט/v1/resolveסקאָפּ: לייזן
פעלדטיפּנויטיקבאַשרייַבונג
urlHTTPS URLיאָפּובליק אָדער אויטאָריזירט מידיאַ בלאַט צו אַנאַליזירן.
tenantשטרינגנייןצוגעשטעלט טענאַנט דאָמיין. געוויינטלעך אויסגעלאָזט.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

צו דערקלערן פֿאָרמאַט אידענטיפיער, טרעננט YTSave די צוריקגעגעבן ווערט אומגעביטן פֿון פּער-לינק בנימצא. אַ עדות רעקאָרד גיט קיין אומגעוויינטלעכע קוואַליטעט לייבעל קיין אייגענע אָרט.

03

שאַפֿן און נאָכפאָלגן אַ אַרבעט פֿאַר אראפקאפיע

פֿאַר אַרבעט שאַפונג, YTSave הייבט אָן מיט אַסינכראָניש צוגרייטונג. זײַן עדות רעקאָרד פּאָרן דאָס מיט אַ קורץ HTTP בקשה און ענדס מיט באַגרענעצט אַרבעטער אויספֿירונג.

פּאָסט/v1/jobsרייַך: אַרבעט
פעלדטיפּנויטיקבאַשרייַבונג
urlHTTPS URLיאָדער זעלבער נאָרמאַליזירטער מקור ארויפגעגעבן צו לייזן.
format_idשטרינגיאָאַ פּינטלעך ID פֿון דער ריזאָלוו ענטפֿער.
tenantשטרינגנייןצוגעשטעלט טענאַנט דאָמיין. געוויינטלעך אויסגעלאָזט.
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 אנגענומעןסאַווע job_id.
2שטימונג סטאַטוסGET /v1/jobs/{job_id} מיט דעם זעלבן שליסל.
3רעדיעפֿענען דעם אונטערשריבן דאַונלאָוד URL.
סטאַטוסבedeutונגקליענט אַקשאַן
queuedצוגעשטעלט צו דער באַגרענעצטער שורה.שטימען ווידער מיט צוריקצאָגרענונג.
extractingריפרעשינג מקור מעטאַדאַטאַ אָדער רוטע.ווייטער פּאָללינג.
processingאראפקאפענונג, רעמאַקסן אָדער צונויפגיסן.ווײַזן סערווירער פּראָגרעס.
readyאונטערשריבן דאַונלאָוד איז בנימצא.שיקן דעם URL צו דעם באַניצער.
failedטערמינאַל סטרוקטורירטער טעותלייענען error_code. פרובירן נאכאמאל בלויז ווען ראַט
expiredטעמפּערערדיק אויסגאַנג איז געווען באַזייַטיקט.שאַפֿן אַ נײַן אַרבעט.
curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSave מאַכט דזשאָב פּאָללינג גרינג צו דורכקוקן. דער בלאַט הייבט אָן מיט איין סעקונדע אָנהייב וואַרטן, גייט צו באַגרענעצט צוריקצאָל, און קלאָר באַשרײַבט טעמפּערער אונטערגעשריבן דעליווערי.

04

פראדיכטבארע ערראָרס

פֿאַר דער ערראָר קאָנטראַקט, YTSave קאָנטראָלירט איין ניט-2xx ענוואַלאָפּע איידער אַ שטיצע בקשה ID. דער בײַשפּיל רעקאָרד מאַכט אויך קלאָר די פאָרויסזאָגן קליענט באַהאַנדלונג.

{
  "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טיפּיש באַדײַטאקשן
400אינוואַליד URL, גוף אָדער ניט בנימצא פֿאָרמאַט.ריכטיק די בקשה. לייזן ווידער פֿאַר פֿאָרמאַטן.
401פעלן, אומגעלייגנט, פאראלטערט אדער פעלערדיקער סקאָפּ שליסל.קוקן דעם סערווער-זייט קרעדענציעל.
403דעם טענאַנט אדער מקור פּאָליטיק האט אָפּגעווייזט דעם בקשה.ניט דורכגיין די פּאָליטיק. קאָנטאַקטירן שטיצע.
404אומבאַקאַנט אָדער פאַרפאַלן אַרבעט.שאַפֿן אַ נײַע אַרבעט אויב פּאַסיק.
429דער בעטן אָדער אַקטיוו אַרבעט גרענעץ איז דערגרייכט.כּבֿוד retry_after_seconds.
503קוועווע/קאַפּאַציטעט אָדער אויבערשטער ליניע טעמפּערערלי נישט בנימצא.פרובירן ווידער מיט עקספּאָנענטיאַל צוריקשטעל און דזשיטער.
05

אָפּעראַציע קאָנטראַקט

YTSave גיט ארויס א ארבעט קוואטע מיט יעדן באשטעטיגונג צו באשיצן דעם API ניצער און די אויבערשטע מידיאַ סערוויסעס.

YTSave האַנדלט שעמע צוטריט דורך ערשטער באַשטימען אַקטיויישאַן איידער אויספֿאָרשונג. עס גייט ווייטער מיט צוגעשטעלטע אָטענטיפֿיקאַציע און האַלט דאַקיומענטירטע בקשות אין דער זעאונג. OpenAPI רעפֿערענץ

אָפּעראַטאָר-איבערגעקוקט צוטריט

בעטן דיין API שליסל

דאַקיומענטירן דעם API קאַנסומער, זײַן חודשלעכן בקשה עסטימאַט און געשטיצט פּלאַטפאָרם רעקווירעמענץ. YTSave איבערקוקט צי ריזאָלוו, אַרבעט סאַבמישאַן אָדער ביידע זענען געריכט איידער אויסגעבן אַ מאָל-זעענדיק שליסל.

בעטן API צוטריט שיסלען זענען טענאַנט-סקאָפּעד, רעוואָקאַבאַל און אויסגעגעבן דורך דעם קאָנטאַקט פאָרעם. אַנאָנימע סקריפּטן קענען נישט דורכפירן אראפקאפיע אַרבעט.