API Ìṣàkóso Ṣíṣe · v1

Kó àwọn ìgbasilẹ pọ̀ pẹ̀lú YTSave

Yan URL ìkànnì àwùjọ àkọsílẹ̀, yan fọ́ọ̀mù tó péye, dá iṣẹ́ àìpẹ̀ṣẹ̀dá sílẹ̀ kí o sì fi abajade tó fọwọ́ sílẹ̀ fún olùmúlò rẹ. Ilana iṣelọpọ tó ní ààlà kan náà ni ń ṣiṣẹ́ fún ojúlé YTSave.

YTSaveClientJSON lori HTTPSAwọn iṣẹ AsynchronousAwọn iwe-ẹri ti a fojusi

Bẹrẹ yara

YTSave ń ṣàkóso olùgbéèrè API nípa ìdánimọ̀ àkọ́kọ́ àwọn ìwé-ẹ̀rí tí a ti ṣiṣẹ́. Ó tẹ̀síwájú pẹ̀lú ipò olùgbéèrè tó yàn àti ń jẹ́ kí ipa-ọ̀nà ìpe sẹ́fààrá tó jẹ́ ti sẹ́fààrá nìkan hàn gbangba.

URL olùgbéhttps://ytsave.app

Ìfọwọ́siX-API-Key: ys_live_…

Profaili alabaraYTSaveClient

Ẹya 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"}'

Lati ṣalaye aabo Ijẹrisi, YTSave ya ibi ipamọ aṣiri ẹgbẹ olupin kuro ninu ko si ifaminsi apoti alabara. Iwe-ẹri ẹri ko fun awọn igbasilẹ gbogbo eniyan tabi awọn ibi ipamọ ni aaye tirẹ.

Yanju ìjápọ̀

YTSave ń ṣàkóso ìṣe Ìpinnu nípa ìdánimọ̀ ìwádìí orísun níkọ̀kọ̀. Ó tẹ̀síwájú pẹ̀lú àwọn fọ́ọ́mátì láti URL kan tó fi ránṣẹ́, kò sì pa àwọn àbájáde tí a ṣe àfihàn mọ́lẹ̀.

FIRANṢẸ/v1/resolveIwọn: yanju

Àgbègbè	Iru	Pataki	Àpejuwe
`url`	URL HTTPS	Bẹẹni	Ojú-ìwé àjọṣepọ̀ tàbí àṣẹ ìtẹ̀jáde láti ṣe àyẹ̀wò.
`tenant`	okùn	Rara	Àdírẹ́sì àgọ́ olùgbé tí a yàn. Nígbà míì a máa foju kọ́.

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

Lati ṣalaye idanimọ Fọọmu, YTSave ya iye ti a pada silẹ laisi iyipada lati wiwa lori ọna asopọ kọọkan. Iwe-ẹri ẹri ko fun ni aami didara ti a gboju le lori ipo tirẹ.

Ṣẹda àti tẹ̀lé iṣẹ́ ìgbàwọlé kan

Fun Ṣiṣẹda Iṣẹ, YTSave bẹrẹ pẹlu igbaradi asynchronous. Iwe-ẹri ẹri rẹ so pọ pẹlu ibeere HTTP kukuru ati pari pẹlu ṣiṣe oṣiṣẹ to lopin.

FIRANṢẸ/v1/jobsÀwọn iṣẹ́: iṣẹ́

Àgbègbè	Iru	Pataki	Àpejuwe
`url`	URL HTTPS	Bẹẹni	Orisun ti a ṣe deede kanna ti a fi silẹ lati yanju.
`format_id`	okùn	Bẹẹni	ID gangan láti ìdáhùn ìpinnu.
`tenant`	okùn	Rara	Àdírẹ́sì àgọ́ olùgbé tí a yàn. Nígbà míì a máa foju kọ́.

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 Ti gbaFipamọ job_id.

2Ipo idiboGET /v1/jobs/{job_id} pẹlu bọtini kanna.

3Tẹ́lẹ̀Ṣii URL igbasilẹ ti a fọwọsi.

Ìpò	Itumọ	Ìṣe oníbàárà
`queued`	Ti gba wọlé sí àtòjọ tó ní ààlà.	Ṣe ìbò lẹ́ẹ̀kansi pẹ̀lú ìdákẹ́jẹ.
`extracting`	Ìmúdàgba àlàyé orísun tàbí ipa-ọna.	Tẹsiwaju ìbò.
`processing`	Ìgbàwọlé, ìṣàtúnṣe tàbí ìṣọ̀kan.	Fihan ìtẹ̀síwájú olupin.
`ready`	Igbasilẹ ti a fọwọsi wa.	Firanṣẹ URL si olumulo.
`failed`	Àṣìṣe tó dá lórí ìpinnu ìpẹ̀yà.	Kà `error_code`. Tun gbiyanju nikan nigbati a ba sọ.
`expired`	Àbájáde àkókò díẹ̀ ni a yọkúrò.	Ṣẹda iṣẹ tuntun kan.

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

YTSave mú kí ìṣàwárí iṣẹ́ rọrùn láti ṣàwárí. Ojúewé bẹ̀rẹ̀ pẹ̀lú ìdákẹ́jẹ ìṣẹ́jú-aaya kan, ń lọ sí ìdákẹ́jẹ tó ní ààlà, tí ó sì sọ ní kedere pé ìfiránṣẹ́ àkọsílẹ̀ àkókò pẹ́.

Awọn aṣiṣe ti a le ṣe asọtẹlẹ

Fún ìwé àṣẹ Àṣìṣe, YTSave ń ṣàyẹ̀wò àpótí kan tó kì í ṣe 2xx kí ó tó ID ìbéèrè ìtìlẹ́yìn. Ìkọ̀wé ẹ̀rí yìí tún jẹ́ kó ṣàfihàn ìmúlò oníbàárà tó dájú.

{
  "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	Ìtumọ̀ àtọkànwá	Ìṣe
400	URL tí kò tọ́, ara tàbí fọ́ọ̀mù tó kò sí.	Ṣàtúnṣe ìbéèrè náà. Ṣàtúnṣe lẹ́ẹ̀kansi fún àwọn fọ́ọ̀mátì.
401	Bọtini ti o nsọnu, ti ko wulo, ti pari tabi ti o ni iwọn aṣẹ ti ko tọ.	Ṣàyẹ̀wò ìjẹ́risi ẹgbẹ́ olùpèsè iṣẹ́.
403	Ilana tenant tàbí orísun kọ ìbéèrè náà.	Ma ṣe foju kọ eto imulo naa. Kan si atilẹyin.
404	Iṣẹ ti a ko mọ tabi ti pari.	Ṣẹda iṣẹ tuntun tí ó bá yẹ.
429	Ìbéèrè tàbí ààrẹ iṣẹ́ tó ń ṣiṣẹ́ ti pé.	Ìyìn `retry_after_seconds`.
503	Àkójọ/agbára tàbí àtẹ̀jáde lókè kò sí ní àkókò yìí.	Tun gbiyanju pẹlu idaduro ilọpo meji ati iyipada.

Ìpinnu iṣẹ́

YTSave n ṣe iṣeduro iṣẹ pẹlu gbogbo ifọwọsi lati daabobo onibara API ati awọn iṣẹ media oke.

Lo ìmúlò àpẹrẹ ìṣàkóso tó dájú kí o má bà a bẹ̀rẹ̀ iṣẹ́ àfíkun fún ìtẹ̀sí ìtẹ̀sí tó jọra fún olùtẹ̀sí kan náà.
Fipamọ metadata ipinnu fun igba diẹ, ṣugbọn ma ṣe tọju awọn URL gbigba lati ayelujara ti a fowo si bi ti o pari.
Lo ìdákẹ́jẹ́ àfikún àkúnya pẹ̀lú ìyípadà fún 429, 503 ati awọn aṣiṣe ti o le tun ṣe.
Ṣe ilana media gbogbo eniyan nikan tabi media ti o ni aṣẹ lati wọle si. DRM ati awọn iṣakoso wiwọle ko ni foju kọ.
Pa awọn ID ibeere ati awọn ID iṣẹ mọ ninu awọn igbasilẹ iṣẹ aladani. Ma ṣe ṣe igbasilẹ awọn URL ti a fi silẹ lai ṣe pataki.

YTSave n ṣakoso wiwọle Schema nipa idanimọ ifasilẹ akọkọ ṣaaju iwadii. O tẹle pẹlu ìfọwọsi ti a yàn ati tọju awọn apẹrẹ ìbéèrè ti a kọ silẹ ni oju. Ìtọ́kasí OpenAPI

WỌLE TI A ṢAYẸWỌN NIPA OPẸRẸTỌ

Béèrè fún bọtìnì API rẹ

Ṣe akọsilẹ onibara API, iṣiro ibeere oṣooṣu rẹ ati awọn ibeere pẹpẹ ti a ṣe atilẹyin. YTSave ṣe atunyẹwo boya ipinnu, ifisilẹ iṣẹ tabi mejeeji jẹ ẹtọ ṣaaju ki o to fun bọtini ti o han lẹẹkan.

Beere iraye si API Awọn bọtini jẹ ti tenant, ti a le fagilee ati ti a fun nipasẹ fọọmu Kan si. Awọn iwe afọwọkọ alailorukọ ko le ṣe iṣẹ olùgbasilẹ.