API REST TÁIRGEADH · v1

Íoslódálacha a thógáil le YTSave

Réitigh URL meán poiblí, roghnaigh formáid chruinn, cruthaigh post asíncrónach agus tabhair an toradh sínithe do do úsáideoir. Soláthraíonn an píblíne táirgthe teoranta céanna an suíomh gréasáin YTSave.

YTSaveClientJSON thar HTTPSJabanna AisioncrónachaDintiúir scóip

Tús tapa

Bainistíonn YTSave óstach API trí chéim amháin a aithint ar dtús na creidiúnaithe a gcuirtear tacaíocht i ngníomh dóibh. Leanann sé le pointe deiridh tionónta a shannadh agus coinníonn sé bealach glaonna freastalaí-amháin le feiceáil.

Url an tionóntahttps://ytsave.app

FíordheimhniúX-API-Key: ys_live_…

Próifíl an chliaintYTSaveClient

Leagan APIv1

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

Chun sábháilteacht Creidmheasa a mhíniú, scarann YTSave stóráil rúnda taobh an fhreastalaí ó aon ionchlannú pacáiste cliant. Ní thugann taifead fianaise aon logaí poiblí ná stóras áit dhúchais dó.

Réitigh nasc

Bainistíonn YTSave oibríocht Réitigh trí bhunús braite a aithint ar dtús. Leanann sé le formáidí ó URL amháin a cuireadh isteach agus ní choinníonn sé aon aschuir chumtha le feiceáil.

POST/v1/resolveRaon feidhme: réiteach

Réimse	Cineál	Riachtanach	Cur Síos
`url`	URL HTTPS	Sea	Leathanach meán poiblí nó údaraithe le haghaidh anailíse.
`tenant`	sreang	Ainm	Fearann tionónta ceaptha. De ghnáth scartha.

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

Chun Aitheantóir Formáid a mhíniú, scarann YTSave an luach a fhilleadh gan athrú ó infhaighteacht in aghaidh na nasc. Ní thugann taifead fianaise aon lipéad cáilíochta measta a áit féin.

Cruthaigh agus lean post íoslódála

Le haghaidh cruthú Post, tosnaíonn YTSave le hullmhúchán asíncrónach. Comhcheanglaíonn a thaifead fianaise sin le hiarratas HTTP gearr agus críochnaíonn sé le feidhmiú oibrithe teoranta.

POST/v1/jobsRaon feidhme: poist

Réimse	Cineál	Riachtanach	Cur Síos
`url`	URL HTTPS	Sea	An foinse normalaithe chéanna a cuireadh isteach le réiteach a fháil.
`format_id`	sreang	Sea	Aitheantas cruinn ón bhfreagra réitigh.
`tenant`	sreang	Ainm	Fearann tionónta ceaptha. De ghnáth scartha.

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 GlacthaSábháil job_id.

2Stádas na pobalbhreitheGET /v1/jobs/{job_id} leis an eochair chéanna.

3RéidhOscail an URL íoslódála sínithe.

Stádas	Brí	Gníomh cliaint
`queued`	Ligean isteach sa scuaine teorannaithe.	Poll arís le cúlú.
`extracting`	Meiteashonraí foinse nó bealach á n-athnuachan.	Lean ar aghaidh ag vótáil.
`processing`	Ag íoslódáil, ag athmhúnlú nó ag cumasc.	Dul chun cinn an fhreastalaí a thaispeáint.
`ready`	Tá íoslódáil shínithe ar fáil.	Seol an URL chuig an úsáideoir.
`failed`	Earráid struchtúrtha teirminéil.	Léigh `error_code`. Déan iarracht arís ach amháin nuair a mholtar.
`expired`	Baineadh aschur sealadach.	Cruthaigh post nua.

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

Déantar éascaíocht scagtha ar pholladh Post le YTSave. Tosaíonn an leathanach le fanacht tosaigh aon soicind, bogann sé go bac ar ais teoranta, agus léiríonn sé go soiléir seachadadh sínithe sealadach.

Earráidí intuartha

Le haghaidh conradh Earráide, seiceann YTSave ceann amháin neamh-2xx clúdach roimh ID iarratais tacaíochta. Déanann an taifead fianaise seo láidir freisin go bhfuil láimhseáil chliant inbhuanaithe soiléir.

{
  "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	Brí tipiciúil	Gníomh
400	URL neamhbhailí, comhlacht nó formáid nach bhfuil ar fáil.	Ceartaigh an iarraidh. Réitigh arís do fhormáidí.
401	Eochair ar iarraidh, neamhbhailí, imithe in éag nó le scóip mícheart.	Seiceáil an dintiúr taobh freastalaí.
403	Dhiúltaigh an tionónta nó an beartas foinse an iarraidh.	Ná seachain an polasaí. Déan teagmháil leis an tacaíocht.
404	Post anaithnid nó as feidhm.	Cruthaigh post nua más cuí.
429	Iarratas nó teorainn gníomhach-phoist bainte amach.	Onóir `retry_after_seconds`.
503	Tá an cíos/acmhainn nó an sreabhadh suas go sealadach neamhghníomhach.	Déan iarracht arís le moill eispéireamach agus jitters.

Conradh oibríochta

Eisíonn YTSave cuóta oibríochta le gach ceadú chun an tomhaltóir API agus seirbhísí meán in aghaidh srutha a chosaint.

Bain úsáid as loighic iarratais idempotent agus ná cuir tús le poist dúblacha riamh don chliceáil úsáideora céanna.
Réitigh meiteashonraí taisce go gearr, ach i gcónaí córais íoslódála sínithe a chóireáil mar a bhfuil siad ag dul in éag.
Úsáid siarghabháil eispéireamach teoranta le jitters do 429, 503 agus earráidí inath-iarrtha.
Próiseáil ach meáin phoiblí nó meáin a bhfuil tú údaraithe chun rochtain a fháil orthu. Ní sheachnaítear DRM agus rialuithe rochtana.
Coinnigh IDanna iarratais agus IDanna jabanna i logs oibríochta príobháideacha. Ná logáil URLanna a cuireadh isteach gan ghá.

Bainistíonn YTSave rochtain ar Schema trí ghníomhachtú a aithint ar dtús sula ndéantar iniúchadh. Leanann sé le húdaráis shonraithe agus coinníonn sé cruthanna iarratais doiciméadaithe le feiceáil. OpenAPI tagartha

ROCHTAIN A BHFUIL OIBRIÚIRÍ AG LÉIRMHEAS

Iarr do eochair API

Doiciméadú a dhéanamh ar an tomhaltóir API, a meastachán iarratais míosúil agus riachtanais an ardáin tacaíochta. Déanann YTSave athbhreithniú ar an réiteach, cur isteach post nó an dá rud sula gcuirtear eochair a bhí le feiceáil uair amháin ar fáil.

Rochtain API a iarraidh Tá eochracha scóip-tionónta, in-aisghairthe agus eisithe tríd an bhfoirm Teagmhála. Ní féidir le scripteanna gan ainm obair íoslódálaí a fhorghníomhú.