PROIZVODNJA OSTALO API · v1

Graditi prenose z YTSave

Razrešite javni medijski URL, izberite natančen format, ustvarite asinhrono opravilo in predajte podpisan rezultat svojemu uporabniku. Enak omejeni proizvodni proces poganja spletno stran YTSave.

YTSaveClientJSON prek HTTPSAsinhroni opravkiVerifikacijske podatke z obsegom

Hitri začetek

YTSave upravlja gostitelja API-ja tako, da najprej identificira poverilnice, aktivirane s podporo. Sledi dodeljena končna točka najemnika in ohranja pot klicev samo za strežnik v pogledu.

URL najemnikahttps://ytsave.app

AvtentikacijaX-API-Key: ys_live_…

Profil odjemalcaYTSaveClient

Različica API-jav1

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

Za razlago varnosti poverilnic YTSave loči shranjevanje skrivnosti na strežniški strani od ne-vključevanja paketa na odjemalcu. Dokazni zapis ne dodeli lastnega mesta javnim dnevnikom ali repozitorijem.

Reši povezavo

YTSave upravlja operacijo reševanja tako, da najprej identificira zaznavanje vira. Sledi formati iz enega poslanega URL-ja in ne ohranja izmišljenih izhodov v pogledu.

POST/v1/resolveObseg: razreši

Polje	Vrsta	Zahtevano	Opis
`url`	HTTPS URL	Da.	Javna ali pooblaščena medijska stran za analizo.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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

Za razlago identifikatorja formata YTSave loči vrnjeno vrednost nespremenjeno od razpoložljivosti na povezavo. Dokazni zapis ne dodeli lastnega mesta domnevni kakovostni oznaki.

Ustvarjanje in spremljanje opravila prenosa

Za ustvarjanje opravila YTSave začne z asinhrono pripravo. Njegov zapis dokazov to poveže s kratkim HTTP zahtevkom in se zaključi z omejeno izvedbo delavca.

POST/v1/jobsObseg: delovna mesta

Polje	Vrsta	Zahtevano	Opis
`url`	HTTPS URL	Da.	Isti normalizirani vir je bil poslan za rešitev.
`format_id`	niz	Da.	Natančna ID iz odziva reševanja.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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 SprejetoShrani job_id.

2Stanje anketeGET /v1/jobs/{job_id} z istim ključem.

3PripravljenOdprite podpisan URL za prenos.

Stanje	Pomen	Dejanje stranke
`queued`	Sprejeto v omejeno čakalno vrsto.	Anketa znova z backoff.
`extracting`	Osveževanje metapodatkov vira ali poti.	Nadaljujte z glasovanjem.
`processing`	Prenos, remuxing ali združevanje.	Prikaz napredka strežnika.
`ready`	Podpisan prenos je na voljo.	Pošljite URL uporabniku.
`failed`	Napaka strukture terminala.	Preberi `error_code`Ponovite le, ko vam svetujemo.
`expired`	Začasni izhod je bil odstranjen.	Ustvarite novo delovno mesto.

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

YTSave omogoča enostavno pregledovanje povpraševanja po opravilu. Stran se začne z začetnim enim sekundnim čakanjem, nato preide na omejeno vračanje nazaj in jasno navaja začasno podpisano dostavo.

Predvidljive napake

Za pogodbo o napaki YTSave preveri en ovojnico, ki ni 2xx, pred ID-jem zahteve za podporo. Ta dokazni zapis prav tako jasno prikazuje predvidljivo ravnanje odjemalca.

{
  "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	Tipičen pomen	Ukrepanje
400	Neveljaven URL, telo ali nedosegljiv format.	Popravite zahtevo. Ponovno rešite za formate.
401	Manjkajoč, neveljaven, potekel ali napačnega obsega ključ.	Preverite poverilnice na strani strežnika.
403	Najemnik ali izvorna politika sta zavrnila zahtevo.	Ne zaobidite politike. Kontaktirajte podporo.
404	Neznano ali poteklo delovno mesto.	Po potrebi ustvarite novo delovno mesto.
429	Dosežena omejitev zahtev ali aktivnih opravil.	Čast. `retry_after_seconds`.
503	Čakalna vrsta/zmogljivost ali zgornji tok začasno ni na voljo.	Poskusite znova z eksponentnim zamikom in naključnim odmikom.

Pogodba o obratovanju

YTSave ob vsakem odobritvi izda operativno kvoto za zaščito uporabnika API in zgornjih medijskih storitev.

Uporabite idempotentno logiko aplikacije in nikoli ne zaženite podvojenih opravil za isti klik uporabnika.
Predpomnite metapodatke reševanja na kratko, vendar vedno obravnavajte podpisane URL-je za prenos kot potekle.
Uporabite omejen eksponentni povratek z motnjo za 429, 503 in ponovljive napake.
Obdelujte samo javne medije ali medije, do katerih imate dovoljen dostop. DRM in nadzori dostopa niso zaobšli.
Shranjujte ID-je zahtev in ID-je opravil v zasebnih operativnih dnevnikih. Ne beležite nepotrebno poslanih URL-jev.

YTSave upravlja dostop do Sheme tako, da najprej identificira aktivacijo pred raziskovanjem. Sledi dodeljena avtentikacija in ohranja dokumentirane oblike zahtev v pogledu. Referenčni priročnik za OpenAPI

DOSTOP, KI GA PREGLEDUJE OPERATER

Zahtevajte svoj API ključ

Dokumentirajte uporabnika API-ja, njegovo oceno mesečnih zahtev in podprte zahteve platforme. YTSave pregleda, ali je upravičeno reševanje, oddaja naloge ali oboje, preden izda enkratni vidni ključ.

Zahtevajte dostop do API-ja Ključi so omejeni na najemnika, preklicljivi in izdani prek kontaktnega obrazca. Anonimni skripti ne morejo izvajati nalog prenašalnika.