PRODUCTION REST API · v1

Manamboara fisintomana miaraka amin'ny YTSave

Vahaolana amin'ny URL haino aman-jery ho an'ny daholobe, fidio ny endrika marina, mamoròna asa asynchronous ary omeo ny vokatra voasonia ny mpampiasa anao. Ity tsipika famokarana voafetra ity ihany no manohana ny tranokala YTSave.

YTSaveClientJSON amin'ny HTTPSAsynchronous jobsFanamarinana voafetra

Fanombohana haingana

Miandraikitra ny mpampiantrano API YTSave amin'ny famantarana voalohany ny mari-pankasitrahana natsangana fanohanana. Manaraka izany ny teboka farany mpanofa voatendry ary mitazona làlana antso mpizara ihany hita maso.

URL mpanofahttps://ytsave.app

Fanaraha-maso ny maha-izyX-API-Key: ys_live_…

Mombamomba ny mpanjifaYTSaveClient

Dikan'ny 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"}'

Mba hanazavana ny fiarovana ny Mari-pankasitrahana, dia manavaka ny fitahirizana tsiambaratelon'ny mpizara amin'ny tsy fampidirana fonosana mpanjifa ny YTSave. Tsy manome toerana ho an'ny firaketana porofo amin'ny loga na tahiry ho an'ny daholobe izany.

Vahaolana rohy

YTSave dia mitantana ny asa Resolve amin'ny famantarana voalohany ny fitiliana loharano. Manaraka izany ny endrika avy amin'ny URL iray natolotra ary tsy mitazona vokatra noforonina amin'ny fijery.

POST/v1/resolveSahan'asa: mamaha

Tsehatra	Karazana	Ilaina	Famaritana
`url`	URL HTTPS	Eny	Pejy ho an'ny haino aman-jery ho an'ny daholobe na nahazo alalana hojerena.
`tenant`	tady	Tsia	Domain mpanofa natokana. Matetika tsy asiana.

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

Mba hanazavana ny Format identifier, manavaka ny sanda averina tsy misy fiovana amin'ny fahafahan'ny rohy tsirairay ny YTSave. Tsy manome toerana ho an'ny marika kalitao vinavinaina ny firaketana porofo.

Mametraha sy araho ny asa fisintomana

Ho an'ny famoronana Asa, YTSave dia manomboka amin'ny fanomanana asynchronous. Ny firaketana porofo dia mampifandray izany amin'ny fangatahana HTTP fohy ary mifarana amin'ny fanatanterahana mpiasa voafetra.

POST/v1/jobsSahan'asa: asa

Tsehatra	Karazana	Ilaina	Famaritana
`url`	URL HTTPS	Eny	Ny loharano voalanjalanja mitovy no natolotra hamahana.
`format_id`	tady	Eny	ID marina avy amin'ny valin'ny fanapahana.
`tenant`	tady	Tsia	Domain mpanofa natokana. Matetika tsy asiana.

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

2Toetran'ny fanadihadianaGET /v1/jobs/{job_id} amin'ny lakile mitovy.

3VononaSokafy ny URL fisintomana voasonia.

Toetry ny	Dikan'ny teny	Hetra mpanjifa
`queued`	Ekena ao amin'ny filaharana voafetra.	Manao fanadihadiana indray miaraka amin'ny fialan-tsasatra.
`extracting`	Manavao ny metadata loharano na lalana.	Tohizo ny fanadihadiana.
`processing`	Misintona, manamboatra na manambatra.	Asehoy ny fandrosoan'ny mpizara.
`ready`	Azo atao ny misintona voasonia.	Alefaso amin'ny mpampiasa ny URL.
`failed`	Hadisoana voarafitra amin'ny terminala.	Vakio `error_code`. Avereno fotsiny rehefa asaina.
`expired`	Nesorina ny vokatra vonjimaika.	Mametraha asa vaovao.

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

YTSave dia mahatonga ny fanadihadiana asa ho mora jerena. Manomboka amin'ny fiandrasana iray segondra ny pejy, mihetsika amin'ny fiverenana voafetra, ary milaza mazava ny fanaterana vonjimaika misy sonia.

Hadisoana azo vinavinaina

Ho an'ny fifanarahana Error, YTSave dia manamarina fonosana iray tsy 2xx alohan'ny ID fangatahana fanohanana. Ity firaketana porofo ity koa dia mampiseho mazava ny fitantanana mpanjifa azo vinavinaina.

{
  "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	Hevitra mahazatra	Hetra
400	URL tsy manankery, vatana na endrika tsy misy.	Ahitsio ny fangatahana. Avereno ny famahana ho an'ny endrika.
401	Tsy hita, tsy manankery, lany daty na fanalahidy tsy mifanaraka amin'ny sehatra.	Hamarino ny mari-pankasitrahana amin'ny lafiny mpizara.
403	Nandà ny fangatahana ny politika mpanofa na loharano.	Aza mandika ny politika. Mifandraisa amin'ny fanohanana.
404	Asa tsy fantatra na lany daty.	Mametraha asa vaovao raha ilaina.
429	Efa tonga amin'ny fetra fangatahana na asa mavitrika.	Voninahitra `retry_after_seconds`.
503	Filaharana/fahafahana na loharano ambony tsy misy vonjimaika.	Miezaha indray miaraka amin'ny fiverimberenana mitombo sy fikorontanana.

Fifanarahana miasa

Ny YTSave dia manome quota miasa miaraka amin'ny fankatoavana tsirairay mba hiarovana ny mpanjifa API sy ny tolotra media ambony.

Ampiasao ny lojika fampiharana idempotent ary aza manomboka asa miverimberina ho an'ny tsindry mpampiasa mitovy.
Mitahiry vetivety ny metadata voavaha, fa mandrakariva raiso ho lany daty ny URL fisintomana voasonia.
Ampiasao ny fiverenan'ny exponential voafetra miaraka amin'ny jitter ho an'ny 429, 503 sy hadisoana azo averina.
Mikarakara media ho an'ny daholobe ihany na media izay nahazoanao alalana hiditra. Tsy azo atao ny mandika DRM sy ny fifehezana fidirana.
Tazomy ao anaty rakitra manokana momba ny asa ny ID fangatahana sy ny ID asa. Aza manoratra amin'ny rakitra ny URL nalefa raha tsy ilaina.

YTSave dia mitantana ny fidirana Schema amin'ny famantarana voalohany ny fanombohana alohan'ny fanadihadiana. Manaraka izany ny fanamarinana natokana ary mitazona ny endrika fangatahana voarakitra ao an-tsaina. Reference OpenAPI

Fidirana Nohamarinin'ny Mpanome Tolotra

Mangataha ny lakilen'ny API anao

Taratasy ny mpanjifa API, ny tombana fangatahana isam-bolana ary ny fepetra takiana amin'ny sehatra tohanana. YTSave dia mandinika raha toa ka ara-drariny ny famahana, ny fandefasana asa na ny roa alohan'ny hanomezana fanalahidy hita indray mandeha.

Mangataka fidirana API Ny fanalahidy dia voafetra amin'ny mpampiasa, azo esorina ary omena amin'ny alalan'ny taratasy fifandraisana. Tsy afaka manatanteraka asa mpisintona ny script tsy fantatra anarana.