ÖNÜMÇILIK REST API · w1

YTSave bilen ýüklemeleri düzüň

Köpçülikleýin media URL-ni çözmek, takyk format saýlamak, asynhron iş döretmek we gol çekilen netijäni ulanyjynyňyza bermek. Şol bir çäkli önümçilik liniýasy YTSave web sahypasyny işleýär.

YTSaveClientHTTPS arkaly JSONAsynkron işleriňÇäkli ygtyýarnamalar

Çalt başlamak

YTSave API myhmanhanasyny ilkinji nobatda goldaw işjeňleşdirilen şahadatnamalary anyklamak arkaly dolandyrýar. Soňra bellenilen tenant nokady bilen dowam edýär we diňe serwer çagyryş ýoluny görkezip saklaýar.

Ijaragär URLhttps://ytsave.app

TassyklamaX-API-Key: ys_live_…

Klient profiliYTSaveClient

API wersiýasyv1

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

Credential howpsuzlygyny düşündirmek üçin YTSave serwer tarapyndaky gizlin saklamany müşderi paketine goşmazdan aýyrýar. Subutnama ýazgyda hiç hili açyk ýazgylar ýa-da ammarlar üçin aýratyn ýer ýok.

Baglanyşygy çözmek

YTSave Çözgüt işini ilkinji nobatda çeşme anyklamak bilen ýerine ýetirýär. Ol bir tabşyrylan URL-den formatlary yzarlap, oýlanylan çykaryşlary görkezijide saklamaýar.

POST/v1/resolveÇägini kesgitlemek

Ýer	Ýazmak	Talap edilýär	Beýan
`url`	HTTPS URL	Hawa	Analiz etmek üçin umumy ýa-da ygtyýarly media sahypasy
`tenant`	setir	Ýok	Belligi berlen tenant domeni. Adatça goýberilýär.

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

Format tanadyjyny düşündirmek üçin YTSave gaýtarylan gymmaty üýtgetmän her baglanyşygyň elýeterliligi bilen aýyrýar. Subutnama ýazgysy çaklanan hili bellik üçin aýratyn ýer berýärok.

Ýüklemek işini dörediň we yzarlap baryň

Iş döredilişi üçin YTSave asynhron taýýarlyk bilen başlaýar. Onuň delil ýazgy gysga HTTP haýyş bilen utgaşýar we çäklenen işçi ýerine ýetiriş bilen tamamlanýar.

POST/v1/jobsMöçber: iş orunlary

Ýer	Ýazmak	Talap edilýär	Beýan
`url`	HTTPS URL	Hawa	Çözmek üçin tabşyrylan şol bir kadalaşdyrylan çeşme.
`format_id`	setir	Hawa	Çözgüt jogabyndan takyk ID.
`tenant`	setir	Ýok	Belligi berlen tenant domeni. Adatça goýberilýä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 Kabul edildiÝatda sakla job_id.

2Sorag ýagdaýyGET /v1/jobs/{job_id} şol bir açar bilen.

3TaýýarGol çekilen ýükleýiş URL-ni aç.

Status	Meni	Müşderiniň hereketi
`queued`	Çäklendirilen nobata kabul edildi.	Yza çekilmek bilen täzeden sorag beriň.
`extracting`	Çeşme metamaglumatlaryny ýa-da ýoly täzeläp bolýar.	Sorag bermäge dowam et.
`processing`	Ýüklenýär, täzeden düzülýär ýa-da birleşdirilýär.	Serweriň ösüşini görkez.
`ready`	Gol çekilen ýükleýiş elýeterli.	Ulanyja URL iberiň.
`failed`	Terminal gurluşly säwlik.	Okamak `error_code`. Diňe maslahat berilende gaýtadan synanyşyň.
`expired`	Wagtylaýyn çykdajy aýryldy.	Täze iş dörediň.

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

YTSave Iş soraglaryny aňsatlyk bilen gözden geçirmäge mümkinçilik berýär. Sahypa bir sekuntlyk ilkinji garaşmak bilen başlaýar, çäklendirilen yzyna çekilmäge geçýär we wagtlaýyn gol çekilen eltip bermek barada aç-açan aýdýar.

Çak edilip bilinýän säwlikler

Ýalňyşlyk şertnamasy üçin YTSave goldaw sorag ID-sinden öň bir sany 2xx däl konwerti barlaýar. Bu subutnama ýazgy müşderiniň garaşylýan işjeňligini hem anyk görkezýär.

{
  "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	Adaty many	Hereket
400	Nädogry URL, mazmun ýa-da elýeterli bolmadyk format.	Haýyşnama dogrylaň. Formatlar üçin täzeden çözüň.
401	Ýitip barýan, nädogry, möhleti geçen ýa-da ýalňyş gerimli açar.	Serwer tarapyndaky ygtyýarnamany barlaň.
403	Ijarçy ýa-da çeşme syýasaty haýyşnamany ret etdi.	Siyasaty geçmäň. Goldaw bilen habarlaşyň.
404	Näsaz ýa-da möhleti geçen iş.	Gerek bolsa täze iş dörediň.
429	Haýyş ýa-da iş çägi doly boldy.	Hormat `retry_after_seconds`.
503	Nobat/kuwwat ýa-da ýokarky akym wagtlaýyn elýeterli däl.	Eksponental yza çekilme we titremä bilen gaýtadan synanyşyň.

Iş şertnamasy

YTSave API ulanyjysyny we ýokarky media hyzmatlaryny goramak üçin her tassyklamada işjeňlik çägi berýär.

Idempotent programma logikasyny ulanyň we bir ulanyjynyň basyşy üçin gaýtalanýan işlere hiç haçan başlamaly däl.
Keşde metamaglumatlary gysga wagt saklaň, ýöne gol goýlan ýükläp almak URL-lerini hemişe möhleti geçen hasaplaň.
Jitter bilen çäklendirilen eksponensial yzyna çekilmegi ulanyň 429, 503 we gaýtadan synanyşylýan säwlikler.
Diňe jemgyýetçilik media ýa-da siziň girmäge ygtyýarlydygyňyz media işlenýär. DRM we giriş gözegçiligi aýrylmaýar.
Haýyş ID-lerini we iş ID-lerini hususy iş ýazgylarynda saklaň. Iňlis URL-leri zerur bolmadyk ýagdaýda ýazmaň.

YTSave Schema elýeterliligini ilkinji nobatda işjeňleşdirmäni anyklamak arkaly dolandyrýar. Soňra bellenilen tassyklamany ýerine ýetirýär we dokumentleşdirilen haýyş görnüşlerini gözegçilikde saklaýar. OpenAPI salgysy

OPERATOR-TARAFLY SEREDILEN GIRIŞ

API açaryňyzy haýyş ediň

API ulanyjysyny, onuň aýlyk sorag çaklamasyny we goldanýan platforma talaplaryny dokumentirle. YTSave, bir gezek görünýän açary bermekden öň çözgüt, iş tabşyryşy ýa-da ikisiniň hem esaslydygyny barlaýar.

API elýeterliligini soraň Açarlar tenant-çäginde, yzyna gaýtarylyp bilinýän we Aragatnaşyk formasy arkaly berilýär. Anonim skriptler downloader işini ýerine ýetirip bilmez.