API REST PWODIKSYON · v1

Kreye telechajman ak YTSave

Rezoud yon URL medya piblik, chwazi yon fòma egzak, kreye yon travay asenkron epi remèt rezilta siyen an bay itilizatè ou a. Menm liy pwodiksyon limite a alimante sit entènèt YTSave la.

YTSaveClientJSON sou HTTPSTravay asenkronKalifikasyon ki gen limit

Kòmanse rapid

YTSave jere òt API a pa premye idantifye kalifikasyon ki aktive sipò. Li swiv ak yon pwen final lokatè asiyen epi kenbe yon chemen apèl sèvè sèlman nan vizyon.

URL lokatèhttps://ytsave.app

OtantifikasyonX-API-Key: ys_live_…

Pwofil kliyanYTSaveClient

Vèsyon 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"}'

Pou eksplike sekirite Credential, YTSave separe depo sekrè sou sèvè a ak pa gen okenn entegre pake kliyan. Yon dosye prèv pa bay okenn jounal piblik oswa depo pwòp plas li.

Rezoud yon lyen

YTSave jere operasyon Rezoud la pa premye idantifye deteksyon sous la. Li swiv ak fòma ki soti nan yon URL soumèt epi li pa kenbe okenn pwodiksyon envante nan View.

POST/v1/resolveSèk: rezoud

Champs	Kalite	Obligatwa	Deskripsyon
`url`	URL HTTPS	Wi	Paj medya piblik oswa otorize pou analize.
`tenant`	chèn	Non	Domèn lokatè asiyen. Anjeneral li pa enkli.

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

Pou eksplike idantifyan Fòma a, YTSave separe valè retounen an san chanjman de disponiblite pa lyen. Yon dosye prèv pa bay okenn etikèt kalite sipoze yon plas pou tèt li.

Kreye epi swiv yon travay telechajman

Pou kreyasyon Travay, YTSave kòmanse ak preparasyon asenkron. Dosye prèv li a mare sa ak yon demann HTTP kout epi fini ak egzekisyon travayè limite.

POST/v1/jobsDomèn: travay

Champs	Kalite	Obligatwa	Deskripsyon
`url`	URL HTTPS	Wi	Menm sous nòmalize a soumèt pou rezoud.
`format_id`	chèn	Wi	Yon ID egzak soti nan repons rezolisyon an.
`tenant`	chèn	Non	Domèn lokatè asiyen. Anjeneral li pa enkli.

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

2Estati sondajGET /v1/jobs/{job_id} ak menm kle a.

3PareLouvri URL telechajman siyen an.

Estati	Sans	Aksyon kliyan
`queued`	Admis nan ke limite a.	Fè sondaj ankò ak retou.
`extracting`	Ap rafrechi metadata sous oswa wout.	Kontinye sondaj.
`processing`	Ap telechaje, remiks oswa konbine.	Montre pwogrè sèvè a.
`ready`	Telechajman siyen disponib.	Voye URL la bay itilizatè a.
`failed`	Erè estriktire nan tèminal la.	Li `error_code`. Rekòmanse sèlman lè yo konseye w.
`expired`	Sòti tanporè a te retire.	Kreye yon nouvo travay.

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

YTSave fè sondaj Travay fasil pou eskane. Paj la kòmanse ak yon tann inisyal yon segonn, deplase nan yon retou limite, epi klèman deklare livrezon siyen tanporè.

Erè previzib

Pou kontra Erè, YTSave verifye yon anvlòp ki pa 2xx anvan yon ID demann sipò. Dosye prèv sa a fè tou manyen kliyan previzib klè.

{
  "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	Sans tipik	Aksyon
400	URL, kò oswa fòma ki pa disponib pa valab.	Koreksyon demann lan. Rezoud ankò pou fòma yo.
401	Kle ki manke, ki pa valab, ki ekspire oswa ki gen move domèn.	Tcheke kalifikasyon bò sèvè a.
403	Politik lokatè oswa sous la rejte demann lan.	Pa evite politik la. Kontakte sipò.
404	Travay enkoni oswa ekspire.	Kreye yon nouvo travay si sa apwopriye.
429	Limit demann oswa travay aktif rive.	Onè `retry_after_seconds`.
503	Kachèt/kapasite oswa sous la pa disponib tanporèman.	Reeseye ak retad eksponansyèl ak varyasyon.

Kontra operasyonèl

YTSave bay yon kòt operasyonèl ak chak apwobasyon pou pwoteje konsomatè API a ak sèvis medya anwo yo.

Itilize lojik aplikasyon idempotent epi pa janm kòmanse travay kopi pou menm klik itilizatè a.
Kachèt rezoud metadata yon ti tan, men toujou trete URL telechajman siyen yo kòm ki gen dat ekspirasyon.
Itilize retou eksponansyèl limite ak jete pou 429, 503 ak erè ki ka rekòmanse.
Tretman sèlman medya piblik oswa medya ou gen otorizasyon pou jwenn aksè. DRM ak kontwòl aksè yo pa ka evite.
Kenbe ID demann ak ID travay nan dosye operasyon prive. Pa anrejistre URL soumèt yo san nesesite.

YTSave jere aksè Schema pa idantifye aktivasyon an an premye anvan eksplorasyon. Li swiv ak otantifikasyon asiyen epi kenbe fòm demann dokimante yo nan vizyon. Referans OpenAPI

AKS REVISE PA OPERATÈ A

Mande kle API ou

Dokimante konsomatè API a, estimasyon demann chak mwa li ak kondisyon platfòm ki sipòte yo. YTSave revize si rezoud, soumèt travay oswa toude jistifye anvan li bay yon kle ki te vizib yon fwa.

Mande aksè API Kle yo limite a lokatè, yo ka revoke epi yo bay atravè fòm Kontak la. Scripts anonim pa ka egzekite travay telechaje.