REST API SAOTHRAICHTE · v1

Tog luchdaich sìos le YTSave

Fhuair URL meadhanan poblach, tagh cruth mionaideach, cruthaich obair asyncronach agus cuir an toradh air a shoidhnigeadh gu do neach-cleachdaidh. Tha an aon loidhne toraidh cuibhrichte a’ cumhachdachadh làrach-lìn YTSave.

YTSaveClientJSON thairis air HTTPSObraichean neo-sioncronachCreideasan cuimsichte

Tòiseachadh luath

Bidh YTSave a’ làimhseachadh aoigheachd API le bhith a’ comharrachadh creideasan a tha air an cur an gnìomh le taic an toiseach. An uairsin lean e le ceann-uidhe màilichte agus cum am pasgadh gairm frithealaiche-a-mhàin ri fhaicinn.

URL màthraicheanhttps://ytsave.app

DearbhadhX-API-Key: ys_live_…

Pròifil neach-dèiligidhYTSaveClient

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

Gus sàbhailteachd teisteanas a mhìneachadh, bidh YTSave a’ sgaradh stòr-dàta dìomhair taobh an fhrithealaiche bho bhith a’ cur pacaid neach-dèiligidh sam bith a-steach. Chan eil clàr fianais a’ toirt àite do logaichean poblach no stòran-dàta.

Fhuasgladh ceangal

Tha YTSave a’ làimhseachadh obrachadh Fuasgladh le bhith a’ comharrachadh lorg stòr an toiseach. An uairsin bidh e a’ leantainn le cruthan bho aon URL a chaidh a chur a-steach agus chan eil toradh sam bith air a chruthachadh ri fhaicinn.

POST/v1/resolveRaon: fuasgladh

Raon	Seòrsa	Riatanach	Tuairisgeul
`url`	URL HTTPS	Tha	Duilleag meadhanan poblach no ùghdarraichte airson anailis a dhèanamh.
`tenant`	teacsa	Chan eil	Dùthaich tenant air a shònrachadh. Mar as trice air a leigeil seachad.

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

Gus mìneachadh a thoirt air comharra-aithne Cruth, bidh YTSave a’ sgaradh an luach air ais gun atharrachadh bho ri fhaighinn gach ceangal. Chan eil àite sònraichte aig clàr fianais airson bileag càileachd air thuaiream.

Cruthaich agus lean obair luchdachadh sìos

Airson cruthachadh Obrach, bidh YTSave a’ tòiseachadh le ullachadh asyncronach. Tha an clàr-fianais aige a’ ceangal sin ri iarrtas HTTP goirid agus a’ crìochnachadh le cur an gnìomh neach-obrach cuibhrichte.

POST/v1/jobsRaon: obraichean

Raon	Seòrsa	Riatanach	Tuairisgeul
`url`	URL HTTPS	Tha	An aon stòr àbhaisteach a chaidh a chur a-steach airson fuasgladh.
`format_id`	teacsa	Tha	ID mionaideach bhon fhreagairt fuasglaidh.
`tenant`	teacsa	Chan eil	Dùthaich tenant air a shònrachadh. Mar as trice air a leigeil seachad.

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 Ghabhadh risSàbhail job_id.

2Inbhe pollGET /v1/jobs/{job_id} le an aon iuchair.

3DeiseilFosgail an URL luchdaich sìos air a shoidhnigeadh.

Inbhe	Ciall	Gnìomh neach-dèiligidh
`queued`	Ghabhadh a-steach dhan chriathrag chuingealaichte.	Dèan suirbhidh a-rithist le dàil.
`extracting`	A’ ùrachadh metadata stòr no slighe.	Lean air adhart a’ faighneachd.
`processing`	A’ luchdachadh sìos, a’ ath-mhìneachadh no a’ measgachadh.	Taisbean do dhòigh-obrach an fhrithealaiche.
`ready`	Tha luchdaich sìos air a shoidhnigeadh ri fhaighinn.	Cuir an URL chun an neach-cleachdaidh.
`failed`	Mearachd structarail terminal.	Leugh `error_code`. Feuch a-rithist dìreach nuair a thèid comhairle a thoirt.
`expired`	Chaidh toradh sealach a thoirt air falbh.	Cruthaich obair ùr.

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

Tha YTSave a' dèanamh sgrùdadh Obrach furasta a sganadh. Bidh an duilleag a' tòiseachadh le feitheamh tùsail aon diog, a' gluasad gu cùl-taic cuibhrichte, agus a' soilleireachadh lìbhrigeadh soidhnichte sealach.

Mearachdan ro-innseach

Airson a' chùmhnant Mearachd, bidh YTSave a' sgrùdadh aon amhlaidh neo-2xx mus tèid ID iarrtais taic a thoirt seachad. Tha an clàr fianais seo cuideachd a' dèanamh soilleir dè cho soilleir 'sa tha làimhseachadh teachdaiche ro-innseach.

{
  "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ìgh àbhaisteach	Gnìomh
400	URL mì-dhligheach, corp no cruth nach eil ri fhaighinn.	Ceartaich an iarrtas. Fuasgladh a-rithist airson cruthan.
401	Iuchair a tha a-mach, mì-laghail, a dh' fhalbh no aig raon ceàrr.	Thoir sùil air teisteanas an fhrithealaiche.
403	Chaidh an iarrtas a dhiùltadh leis a’ phoileasaidh sealbhadair no stòr.	Na cuir seachad an poileasaidh. Cuir fios gu taic.
404	Obair neo-aithnichte no a tha air crìochnachadh.	Cruthaich obair ùr ma tha sin iomchaidh.
429	Tha an iarrtas no an crìoch obrach gnìomhach air a ruigsinn.	Urram `retry_after_seconds`.
503	Sreath/ comas no sruth suas gun fhaighinn gu sealach.	Feuch a-rithist le ath-thòiseachadh exponential agus jitter.

Cùmhnant obrachail

Tha YTSave a’ toirt seachad cuibhreann obrachail le gach cead gus luchd-cleachdaidh API agus seirbheisean meadhanan àrd-ìre a dhìon.

Cleachd loidsig tagraidh idempotent agus na tòisich obair dùblaichte airson an aon bhriogadh neach-cleachdaidh a-riamh.
Fuasgladh metadata cache gu goirid, ach an-còmhnaidh làimhseachadh URLan luchdaich sìos air an soidhnigeadh mar a tha iad a’ crìonadh.
Cleachd cùl-taic exponential cuibhrichte le jitter airson 429, 503 agus mearachdan a ghabhas feuchainn a-rithist.
Pròiseas dìreach meadhanan poblach no meadhanan air a bheil cead agad faighinn thuca. Cha tèid DRM agus smachdan ruigsinneachd a sheachnadh.
Cùm IDan iarrtais agus IDan obrach ann an logaichean obrachaidh prìobhaideach. Na cuir a-steach URLan a chaidh a chur a-steach gu mì-chudromach.

Bidh YTSave a’ làimhseachadh ruigsinneachd Schema le bhith a’ comharrachadh gnìomhachadh an toiseach mus tòisich e air sgrùdadh. Lean e le dearbhadh aithneachaidh agus cùm cruthan iarrtais sgrìobhte ri fhaicinn. Iomradh OpenAPI

COTHROMACHD AIR A DHÈANAMH LE LUCHD-OBRACH

Iarr do iuchair API

Sgrìobh sìos neach-cleachdaidh API, an tomhas iarrtas mìosail aige agus feumalachdan àrd-ùrlar taicichte. Bidh YTSave a’ dèanamh lèirmheas air a bheil fuasgladh, cur a-steach obair no an dà chuid air an dèanamh ceart mus tèid iuchair a chaidh fhaicinn aon uair a thoirt seachad.

Iarr ruigsinneachd API Tha iuchraichean air an cuingealachadh do luchd-còmhnaidh, faodar an toirt air ais agus tha iad air an toirt seachad tro fhoirm Conaltraidh. Chan urrainn sgriobtaichean gun urra obair luchd-luchdaidh a chur an gnìomh.