RAŽOŠANAS REST API · v1

Lejupielādējiet būves ar YTSave

Atrisiniet publisku multivides URL, izvēlieties precīzu formātu, izveidojiet asinhronu darbu un nododiet parakstīto rezultātu savam lietotājam. Tā pati ierobežotā ražošanas plūsma darbina vietni YTSave.

YTSaveClientJSON, izmantojot HTTPSAsinhronie darbiAptvertie akreditācijas dati

Ātrās sākšanas rokasgrāmata

YTSave apstrādā API saimnieku, vispirms identificējot atbalsta aktivizētās akreditācijas datus. Tas turpina ar piešķirto nomnieka galapunktu un saglabā tikai servera zvana ceļu redzamībā.

Nomnieka URLhttps://ytsave.app

AutentifikācijaX-API-Key: ys_live_…

Klienta profilsYTSaveClient

API versijav1

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

Lai izskaidrotu Akreditācijas drošību, YTSave atdala servera puses slepeno glabāšanu no klienta pakotnes neiekļaušanas. Pierādījumu ieraksts nepiešķir publiskajiem žurnāliem vai krātuvēm atsevišķu vietu.

Saites atrisināšana

YTSave apstrādā Atrisināšanas operāciju, vispirms identificējot avota noteikšanu. Tas seko formātiem no viena iesniegtā URL un neuztur izgudrotas izvades skatā.

PAST/v1/resolveDarbības joma: atrisināt

Lauks	Tips	Nepieciešams	Apraksts
`url`	HTTPS URL	Jā	Publiska vai pilnvarota mediju lapa analīzei.
`tenant`	virkne	Nē	Piešķirtais nomnieka domēns. Parasti izlaists.

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

Lai izskaidrotu Formāta identifikatoru, YTSave atdala atgriezto vērtību nemainītu no pieejamības pa saitēm. Pierādījumu ieraksts nepiešķir minētajai kvalitātes kategorijai atsevišķu vietu.

Izveidot un sekot lejupielādes uzdevumam

Darba izveidei YTSave sākas ar asinhronu sagatavošanos. Tā pierādījumu ieraksts savieno to ar īsu HTTP pieprasījumu un beidzas ar ierobežotu darbinieka izpildi.

PAST/v1/jobsDarbības joma: darba vietas

Lauks	Tips	Nepieciešams	Apraksts
`url`	HTTPS URL	Jā	Tika iesniegts tas pats normalizētais avots, lai atrisinātu.
`format_id`	virkne	Jā	Precīzs ID no atrisināšanas atbildes.
`tenant`	virkne	Nē	Piešķirtais nomnieka domēns. Parasti izlaists.

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 PieņemtsSaglabāt job_id.

2Aptaujas statussGET /v1/jobs/{job_id} ar to pašu atslēgu.

3GatavsAtvērt parakstīto lejupielādes URL.

Statuss	Nozīme	Klienta darbība
`queued`	Iesniegts ierobežotajā rindā.	Aptauja vēlreiz ar atkāpšanos.
`extracting`	Avota metadatu vai maršruta atsvaidzināšana.	Turpiniet aptauju.
`processing`	Lejupielāde, pārkodēšana vai apvienošana.	Parādīt servera progresu.
`ready`	Parakstīta lejupielāde ir pieejama.	Nosūtiet vietrādi URL lietotājam.
`failed`	Termināla strukturēta kļūda.	Lasīt `error_code`Atkārtojiet mēģinājumu tikai tad, kad ieteicams.
`expired`	Pagaidu izvade tika noņemta.	Izveidojiet jaunu darbu.

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

YTSave padara darba aptauju viegli skenējamu. Lapa sākas ar vienas sekundes sākotnējo gaidīšanu, pāriet uz ierobežotu atkāpšanos un skaidri norāda pagaidu parakstītu piegādi.

Paredzamās kļūdas

Kļūdu līgumam YTSave pārbauda vienu ne-2xx aploksni pirms atbalsta pieprasījuma ID. Šis pierādījumu ieraksts arī skaidri parāda paredzamo klienta apstrādi.

{
  "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	Tipiska nozīme	Darbība
400	Nederīgs URL, pamatteksts vai nepieejams formāts.	Labojiet pieprasījumu. Mēģiniet vēlreiz formātiem.
401	Trūkst, nederīgs, beidzies vai nepareiza darbības joma atslēga.	Pārbaudīt servera puses akreditācijas datus.
403	Nomnieka vai avota politika noraidīja pieprasījumu.	Nepārkāpiet politiku. Sazinieties ar atbalstu.
404	Nezināms vai beidzies darba laiks.	Ja nepieciešams, izveidojiet jaunu uzdevumu.
429	Sasniegts pieprasījumu vai aktīvo darbu ierobežojums.	Gods `retry_after_seconds`.
503	Rinda/kapacitāte vai augšupejošais savienojums pagaidām nav pieejams.	Atkārtoti mēģiniet ar eksponenciālu atpakaļejošu aizkavi un traucējumiem.

Darbības līgums

YTSave katras apstiprināšanas laikā izsniedz darbības kvotu, lai aizsargātu API patērētāju un augšupvērstos multivides pakalpojumus.

Izmantojiet idempotent lietojumprogrammu loģiku un nekad nesāciet dublēt darbus vienam un tam pašam lietotāja klikšķim.
Kešatmiņa īsi atrisina metadatus, bet vienmēr uzskata, ka parakstītie lejupielādes URL ir beigušies.
Izmantojiet ierobežotu eksponenciālo atpakaļejošo aizkavi ar nejaušību 429, 503 un atkārtojamām kļūdām.
Apstrādājiet tikai publisku multividi vai multividi, kurai jums ir piekļuve. DRM un piekļuves kontroles netiek apietas.
Saglabājiet pieprasījumu ID un darba ID privātos darbības žurnālos. Nelietojiet iesniegtos URL nevajadzīgi.

YTSave apstrādā shēmas piekļuvi, vispirms identificējot aktivizāciju pirms izpētes. Tas seko piešķirtajai autentifikācijai un saglabā dokumentētas pieprasījuma formas skatā. OpenAPI atsauces

EKSPLUATANTA PĀRBAUDĪTA PIEKĻUVE

Pieprasiet savu API atslēgu

Dokumentējiet API patērētāju, tā ikmēneša pieprasījumu aplēsi un atbalstītās platformas prasības. YTSave pārskata, vai pirms vienreiz redzama atslēgas izsniegšanas ir pamatoti atrisinājums, darba iesniegšana vai abi.

Pieprasīt API piekļuvi Atslēgas ir īrnieka mērogā, atsaucamas un izsniegtas caur Kontaktformu. Anonīmi skripti nevar izpildīt lejupielādētāja darbu.