PRODUKTA REST API · v1

Konstrui elŝutojn kun YTSave

Solvu publikan amaskomunikilan URL-on, elektu precizan formaton, kreu asincronan taskon kaj transdonu la subskribitan rezulton al via uzanto. La sama limigita produktadlinio funkciigas la retejon YTSave.

YTSaveClientJSON super HTTPSAsinkronaj taskojLimigitaj atestiloj

Rapida starto

YTSave traktas API-gaston unue identigante subten-aktivigitajn atestilojn. Ĝi sekvas per asignita luanto-fina punkto kaj konservas servilan nur vokvojon en vido.

Luanto URLhttps://ytsave.app

AŭtentikigoX-API-Key: ys_live_…

Klienta profiloYTSaveClient

API-versiov1

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

Por klarigi Kredencialan sekurecon, YTSave apartigas servilan sekretan stokadon de neniu klienta pakaĵa enmeto. Evidenteca registro ne donas publikan taglibron aŭ deponejon sian propran lokon.

Solvi ligilon

YTSave pritraktas Rezolucian operacion unue identigante fontan detekton. Ĝi sekvas kun formatoj de unu submetita URL kaj ne konservas inventitajn eligojn en vido.

POST/v1/resolveSkopo: solvi

Kampo	Tipo	Necesa	Priskribo
`url`	HTTPS URL	Jes	Publika aŭ rajtigita amaskomunikila paĝo por analizi.
`tenant`	ĉeno	Ne	Asignita luanto-domajno. Kutime forlasita.

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

Por klarigi Format-identigilon, YTSave apartigas la revenitan valoron senŝanĝe de disponeblo laŭ ligilo. Evidentiga registro ne donas al supozita kvalita etikedo propran lokon.

Krei kaj sekvi elŝutan taskon

Por Labor-kreado, YTSave komencas per asinĥrona preparado. Ĝia evidenteca registro kombinas tion kun mallonga HTTP-peto kaj finiĝas per limigita laborista efektivigo.

POST/v1/jobsGamo: laborpostenoj

Kampo	Tipo	Necesa	Priskribo
`url`	HTTPS URL	Jes	La sama normigita fonto submetita por solvi.
`format_id`	ĉeno	Jes	Preciza ID el la respondaro de rezolucio.
`tenant`	ĉeno	Ne	Asignita luanto-domajno. Kutime forlasita.

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

2VoĉdonstatoGET /v1/jobs/{job_id} kun la sama ŝlosilo.

3PretajMalfermu la subskribitan elŝutan URL.

Stato	Signifo	Klienta ago
`queued`	Akceptita en la limigita vico.	Denove voĉdoni kun malfruo.
`extracting`	Refreŝigante fontan metadatenojn aŭ vojon.	Daŭrigi sondadon.
`processing`	Elŝutante, remiksante aŭ kunfandante.	Montri servilan progreson.
`ready`	Subskribita elŝuto estas disponebla.	Sendu la URL al la uzanto.
`failed`	Terminala strukturita eraro.	Legi `error_code`. Provu denove nur kiam konsilite.
`expired`	Provizora rezulto estis forigita.	Krei novan taskon.

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

YTSave faciligas skani Taskan sondadon. La paĝo komenciĝas per unu-sekunda komenca atendo, moviĝas al limigita malantaŭeniro, kaj klare deklaras provizoran subskribitan liveradon.

Antaŭvideblaj eraroj

Por Erara kontrakto, YTSave kontrolas unu ne-2xx-envelopon antaŭ subtenan petan ID-on. Ĉi tiu evidenteca registro ankaŭ klare montras antaŭvideblan klientan traktadon.

{
  "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	Tipa signifo	Ago
400	Nevalida URL, enhavo aŭ neatingebla formato.	Korekti la peton. Rezolvu denove por formatoj.
401	Mankanta, nevalida, eksvalidiĝinta aŭ malĝusta-sfero ŝlosilo.	Kontrolu la servilan atestilon.
403	Luanto aŭ fonta politiko rifuzis la peton.	Ne preterpasi la politikon. Kontaktu subtenon.
404	Nekonata aŭ eksvalidiĝinta tasko.	Kreu novan taskon se taŭgas.
429	Petita aŭ aktiva laborlimo atingita.	Honoron `retry_after_seconds`.
503	Vico/kapacito aŭ suprena fluo provizore ne disponeblas.	Reprovi kun eksponenta malfruo kaj ŝanceliĝo.

Operacia kontrakto

YTSave eldonas operacian kvoton kun ĉiu aprobo por protekti la API-uzanton kaj la supraj amaskomunikilaj servoj.

Uzu idempotentan aplikaĵlogikon kaj neniam komencu duplikatajn taskojn por la sama uzantklako.
Kaŝmemoru solvan metadatenon mallonge, sed ĉiam traktas subskribitajn elŝutajn URL-ojn kiel eksvalidiĝantajn.
Uzi limigitan eksponentan malfruon kun ŝanceliĝo por 429, 503 kaj ripeteblaj eraroj.
Procesu nur publikan amaskomunikilaron aŭ amaskomunikilaron, al kiu vi estas rajtigita aliri. DRM kaj aliraj kontroloj ne estas preterpasataj.
Konservu petidentigilojn kaj taskidentigilojn en privataj operaciaj protokoloj. Ne protokolu senditajn URLojn senbezone.

YTSave pritraktas Skeman aliron unue identigante aktivigon antaŭ esplorado. Ĝi sekvas per asignita aŭtentikigo kaj konservas dokumentitajn petformojn videblaj. OpenAPI-referenco

OPERACIEJO REVIZIITA ALIRO

Petu vian API-ŝlosilon

Dokumentu la API-uzanton, ĝian monatan petan takson kaj subtenatajn platformajn postulojn. YTSave revizias ĉu solvo, taska sendado aŭ ambaŭ estas pravigitaj antaŭ ol eldoni unufoje videblan ŝlosilon.

Petu API-aliron Ŝlosiloj estas limigitaj al luanto, revokeblaj kaj eldonitaj per la Kontaktformularo. Anonimaj skriptoj ne povas plenumi elŝutilan laboron.