PRODUCTIONIS REST API · v1

Aedifica descensiones cum YTSave

Publicam media URL resolvere, exactum formam eligere, asynchronum opus creare et signatum effectum usori tuo tradere. Eadem finita productio pipeline website YTSave potestatem habet.

YTSaveClientJSON per HTTPSOpera AsynchronaCredentiae limitatae

Celer initium

YTSave tractat exercituum API primum creditialia supportu activata identificando. Sequitur cum endpoint tenantis assignato et semitam vocationis solum-servo in conspectu tenet.

URL conductorishttps://ytsave.app

AuthenticatioX-API-Key: ys_live_…

Profilum clientisYTSaveClient

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

Ad explicandam securitatem credentialium, YTSave secretam repositam in latere servientis ab inclusione fasciculi clientis separat. Tabula testimonii nullis publicis actis nec repositoriis locum proprium tribuit.

Solvere nexum

YTSave operationem Resolve tractat, primum fontis detectionem identificando. Deinde formas ex uno URL submisso sequitur et nullos inventos exitus in conspectu tenet.

POST/v1/resolveAmbitus: solvere

Campus	Typus	Necessarius	Descriptio
`url`	HTTPS URL	Ita	Pagina media publica vel auctoritate data ad analysin.
`tenant`	stringa	Minime	Dominus conductus assignatus. Saepe omittitur.

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

Ad explicandum identificatorem formati, YTSave valorem reddit unum separatum ab disponibilitate pro singulis nexibus. Commentarium testificatorium nulli praesumptae qualitatis titulo proprium locum dat.

Crea et sequere opus descensus

Ad creationem operis, YTSave incipit cum praeparatione asynchrona. Eius testimonium hoc cum brevi petitione HTTP coniungit et cum executione opificis limitata terminat.

POST/v1/jobsAmbitus: officia

Campus	Typus	Necessarius	Descriptio
`url`	HTTPS URL	Ita	Eadem norma fons subiectus ad solvendum.
`format_id`	stringa	Ita	ID exacta ex responsione solutionis.
`tenant`	stringa	Minime	Dominus conductus assignatus. Saepe omittitur.

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

2Status suffragiiGET /v1/jobs/{job_id} cum eodem clave.

3ParatusAperi URL descarcandi signatam.

Status	Significatio	Actio clientis
`queued`	Admissus in ordinem limitatum.	Iterum suffragium cum mora.
`extracting`	Renovans fontem metadata vel iter.	Percontationem pergere.
`processing`	Descensio, remixtio vel coniunctio.	Progressum ministri ostende.
`ready`	Descarcare signata praesto est.	URL ad usorem mitte.
`failed`	Error structurae terminalis.	Lege `error_code`. Iterum tenta tantum cum suadetur.
`expired`	Exitus temporarius removitus est.	Creare novum opus.

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

YTSave inspectionem operum facilem ad perspiciendum reddit. Pagina cum initiali exspectatione unius secundi incipit, ad retrorsum limitatum transit, et clare traditionem temporariam signatam indicat.

Erroribus praedicibilibus

Pro contractu Error, YTSave unum involucrum non-2xx ante ID petitionis subsidii inspicit. Haec scriptura etiam clarum reddit tractationem clientis praevidendam.

{
  "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	Significatio typica	Actio
400	URL invalidum, corpus vel forma non praesto.	Rectifica petitionem. Iterum solve pro formatis.
401	Clavis deest, invalida, exspirata vel ambitus incorrectus.	Reprehende testimonium in parte servo.
403	Tenant vel politica fontis petitionem repudiavit.	Noli praeceptum praeterire. Contactum auxilium.
404	Officium ignotum vel exspiratum.	Creare novum opus si idoneum est.
429	Petitionem aut munus activum terminum pervenit.	Honos `retry_after_seconds`.
503	Ordinem/capacitatem aut flumen superius ad tempus non praesto est.	Itera cum incremento exponentiali et motu incerto.

Contractus operativus

YTSave partem quotae operationalis cum unaquaque approbatione emittit ut API consumptorem et media officia upstream tueatur.

Utere logica applicationis idempotenti et numquam duplos labores pro eodem clicculo usoris incipe.
Cachum metadata breviter resolve, sed URLs signatas ad depromendum semper ut caducas tracta.
Utere exsecutione exponentiali limitata cum motu incerto pro 429, 503 et errores repetibiles.
Processus tantum media publica aut media ad quae accedere licet. DRM et moderationes accessūs non circumveniuntur.
Serva IDs petitionum et IDs operum in commentariis operativis privatīs. Noli URLs submissas sine necessitate consignare.

YTSave tractat Schema access primum activationem identificando ante explorationem. Deinde sequitur authenticationem assignatam et formas petitionis documentatas in conspectu tenet. Referentia OpenAPI

ACCESSUS A OPERATORE REVISUS

Roga clavem tuam API

Documenta API consumptorem, eius menstruae petitionum aestimationem et requisita suggestus sustentati. YTSave perpendit utrum resolutio, missio operis an utrumque iustificata sint antequam clavem semel visibilem emittat.

Petere accessum API Claves ad usum tenantis destinatae sunt, revocari possunt, et per formulam Contactus eduntur. Scripta anonymia opus deponendi exsequi non possunt.