PRODUKSHON REST API · v1

Krea descarga ku YTSave

Resolvé un URL di media públiko, selekshoná un formato eksakto, kreá un trabou asínkrono i duna e resultado firmá na bo usuario. E mesun pipeline di produksion limitado ta alimentá e website YTSave.

YTSaveClientJSON riba HTTPSTrabou asincrónikoKredensialnan ku limitashon

Komensamentu rapidu

YTSave ta maneha host di API pa kuminsá ku identifikashon di kredensialnan aktivá pa soporte. E ta sigui ku un endpoint di tenant asigná i ta mantene un ruta di yamada server solamente na bista.

URL di tenanthttps://ytsave.app

AutenticashonX-API-Key: ys_live_…

Perfil di klientYTSaveClient

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

Pa splika seguridat di Credensial, YTSave ta separá almacenamiento sekretu na server di no inkluí ningun bundel di klient. Un registro di evidencia no ta duna ningun log público òf repositorio su propio lugá.

Resolví un link

YTSave ta maneha operashon di Resolvé pa promé identifiká detekshon di fuente. E ta sigui ku formát for di un URL someté i no ta mantene output inventá den bista.

POST/v1/resolveAlcance: resolvé

Kampo	Tipo	Rekisa	Deskripshon
`url`	URL HTTPS	Si	Página di media públiko òf autorizá pa analiza.
`tenant`	string	No	Dominio di tenant asigná. Normalmente no ta inkluí.

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

Pa splika Identifikadó di Formato, YTSave ta separa e balor retorná sin kambia for di disponibilidad pa kada link. Un registro di evidencia no ta duna ningun label di kalidat ku ta suponé su propio lugá.

Krea i sigui un trabou di descarga

Pa kreashon di trabou, YTSave ta kuminsa ku preparashon asínkrono. Su rekord di evidensia ta kompará esaki ku un petishon HTTP kortiku i ta termina ku eksekushon delimitá di trabou.

POST/v1/jobsAlcance: trabou

Kampo	Tipo	Rekisa	Deskripshon
`url`	URL HTTPS	Si	E mesun fuente normalisá a wordu sometí pa resolvé.
`format_id`	string	Si	Un ID eksakto for di e respuesta di resolushon.
`tenant`	string	No	Dominio di tenant asigná. Normalmente no ta inkluí.

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 AceptáGuarda job_id.

2Estado di encuestaGET /v1/jobs/{job_id} ku e mesun yave.

3ListoHabri e URL di descarga firmá.

Estado	Signifikado	Accion di cliente
`queued`	Admití na e cola delimitá.	Hasi votashon di nobo ku retardo.
`extracting`	Ta refreskando metadato di fuente òf ruta.	Sigui ku e sondeo.
`processing`	Ta descargá, remux of kombiná.	Muestra progreso di server.
`ready`	Descarga firmá ta disponibel.	Manda e URL na e usuario.
`failed`	Error estructurá di terminal.	Lè `error_code`. Tenta di nobo solamente ora ta rekomendá.
`expired`	Salidanan temporal a wordu eliminá.	Krea un trabou nobo.

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

YTSave ta hasi e sondeo di trabou fasil pa eskaneá. E página kuminsá ku un espera inicial di un segundo, pasa na un retroceso limitado, i kla ta indiká entrega temporal firmá.

Error ku por ta prevedí

Pa kontrakto di Error, YTSave ta kontrolá un sobre ku no ta 2xx promé di un ID di petishon di soporte. E rekord di evidensia aki tambe ta kla pa manejamentu predecibel di klient.

{
  "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	Signifikado típico	Accion
400	URL no válido, kuerpo of formato no disponibel.	Korektá e petishon. Resolvé di nobo pa formáto.
401	Yave falta, inválido, caduká òf ku un ámbito inkorekt.	Kontrolá e kredensial na server.
403	Polisianan di tenant òf fuente a rejehá e petishon.	No pasa riba e polítika. Kontakto soporte.
404	Trabou no konosí of kadu	Krea un trabou nobo si ta apropia.
429	Límite di petishon òf trabou aktivo a yega.	Honra `retry_after_seconds`.
503	Fila/kapasidat òf upstream temporalmente no ta disponibel.	Tenta di nobo ku un retraso eksponensial i jitter.

Kontrakt operacional

YTSave ta duna un kuota operashonal ku kada aprobashon pa protehá e konsumer API i e servisio di media riba e nivel ariba.

Usa lógica di aplikashon idempotente i nunca kuminsá trabou duplicá pa e mesun klik di usuario.
Kaché metadata di resolushon pa un momentu, pero semper trata URLnan di descarga firmá como ku ta expira.
Usa un retardo exponensial limitado ku jitter pa 429, 503 i errornan ku por ta intenta di nobo.
Procesa solamente media publiko òf media ku bo tin autorizashon pa aksesá. DRM i kontrolnan di akses no ta salta.
Manten IDnan di petishon i IDnan di trabou den lognan operashonal privá. No registra URLnan ku a somete sin nesesidat.

YTSave ta maneha akseso di Schema pa primé identifiká aktivashon promé ku eksplorashon. E ta sigui ku autentikashon asigná i ta mantene forma di petishon dokumentá den bista. Referensia OpenAPI

ACCESO REVISÁ PA OPERADOR

Pidi bo yave API

Dokumentá e konsumer di API, su estimashon di petishon mensual i e rekisito di plataforma soportá. YTSave ta revisá si resolvé, sumishon di trabou òf dos ta justifiká promé ku ta emité un yave ku tabata bista un biaha.

Pidi acceso API E llave ta limitado pa tenant, por wordu revoká i ta duna via e formulario di Kontakt. Script anónimo no por hasi trabou di downloader.