Csak előzetes verzió – aktiválás szükséges

Letöltések összeállítása a Social Video Saver segítségével

A SocialVideoSaver ezt a hálózaton átnyúló sémát biztosítja a technikai tervezéshez. A gyártási hitelesítő adatok addig maradnak inaktívak, amíg a javasolt felhasználási eset át nem megy a támogatási felülvizsgálaton.

SocialSaverWorkspaceJSON HTTPS-en keresztülAszinkron feladatokHatókörrel rendelkező hitelesítő adatok

Gyors kezdés

A támogatás által aktivált hitelesítő adatok a kiindulópont az API hosztnál a SocialVideoSaver-en. Egy többforrású nézet ezután bemutat egy hozzárendelt bérlői végpontot, és elmagyaráz egy kizárólag szerveroldali hívási útvonalat.

Bérlő URL-jehttps://socialvideosaver.com

HitelesítésX-API-Key: pending_activation_…

Az ügyfél profiljaSocialSaverWorkspace

Az API verziójav1

# Available only after support activation
export SVS_WORKSPACE_KEY="issued-after-review"

curl -X POST https://socialvideosaver.com/v1/resolve \
  -H "X-API-Key: $SVS_WORKSPACE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"social_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

A SocialVideoSaver többforrásos nézete áttekinti a szerveroldali titkos tárolást a Hitelesítő adatok biztonsága érdekében. Nem mutat be kliens csomag beágyazást, és nem takarja el a nyilvános naplókat vagy tárolókat.

Hivatkozás feloldása

A forrásfelismerés a Resolve művelet kiindulópontja a SocialVideoSaver-en. Egy többforrásos nézet ezután bemutatja a formátumokat egy beküldött URL-ből, és elmagyarázza, hogy nincs kitalált kimenet.

POST/v1/resolveHatály: megoldani

Mező	Típus	Kötelező	Leírás
`social_url`	HTTPS URL	Igen.	Nyilvános vagy engedélyezett médiaoldal elemzése.
`tenant`	karakterlánc	Nem.	Hozzárendelt bérlői domain. Általában elhagyható.

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

A SocialVideoSaver többforrásos nézete változatlanul áttekinti a visszakapott értéket a Formátumazonosító esetén. Megjeleníti a linkenkénti elérhetőséget, és nem takarja el a nem becsült minőségi címkét.

Letöltési feladat létrehozása és követése

A SocialVideoSaver az Aszinkron előkészítésen keresztül közelíti meg a Feladat létrehozását, majd egy rövid HTTP-kérést alkalmaz. A többforrásos nézet egyértelművé teszi a korlátozott munkavégzést.

POST/v1/jobsHatály: munkahelyek

Mező	Típus	Kötelező	Leírás
`social_url`	HTTPS URL	Igen.	Ugyanaz a normalizált forrás került benyújtásra megoldásra.
`media_profile`	karakterlánc	Igen.	Egy pontos azonosító a feloldási válaszból.
`tenant`	karakterlánc	Nem.	Hozzárendelt bérlői domain. Általában elhagyható.

curl -X POST https://socialvideosaver.com/v1/jobs \
  -H "X-API-Key: $SVS_WORKSPACE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"social_url":"https://www.youtube.com/watch?v=VIDEO_ID","media_profile":"18"}'

1202 ElfogadvaMentés delivery_job.

2A szavazás állapotaGET /v1/jobs/{delivery_job} ugyanazzal a kulccsal.

3KészNyissa meg az aláírt letöltési URL-t.

Állapot	Jelentése	Ügyfél akció
`queued`	Felvétel a korlátozott várólistára.	Újra szavazás hátraléptetéssel.
`extracting`	Forrás metaadatok vagy útvonal frissítése.	Folytasd a szavazás.
`processing`	Letöltés, remuxing vagy egyesítés.	Kiszolgáló előrehaladásának megjelenítése.
`ready`	Aláírt letöltés elérhető.	Küldje el az URL-t a felhasználónak.
`failed`	Terminál strukturált hiba.	Olvasd el `error_code`Csak akkor próbálkozzon újra, ha azt tanácsolják.
`expired`	Az ideiglenes kimenetet eltávolították.	Hozzon létre egy új feladatot.

curl https://socialvideosaver.com/v1/jobs/DELIVERY_JOB \
  -H "X-API-Key: $SVS_WORKSPACE_KEY"

A SocialVideoSaver a feladat lekérdezést egy másodperces kezdeti várakozás köré szervezi. Többszörös forrásnézete összehasonlítja a korlátozott visszalépést. Az ideiglenes aláírt kézbesítés marad az utolsó ellenőrzés.

Kiszámítható hibák

A SocialVideoSaver-ben egy nem 2xx boríték jelenik meg először az Error szerződés magyarázatakor. Ezt a többforrásos nézet követi egy támogatási kérelem azonosítóval, és kiszámítható klienskezeléssel zárul.

{
  "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	Tipikus jelentése	Akció
400	Érvénytelen URL, tartalom vagy nem elérhető formátum.	Javítsa a kérést. Oldja meg újra a formátumokért.
401	Hiányzó, érvénytelen, lejárt vagy rossz hatókörű kulcs.	Ellenőrizze a kiszolgálóoldali hitelesítő adatokat.
403	A bérlő vagy a forrás irányelve elutasította a kérést.	Ne kerülje meg a szabályzatot. Lépjen kapcsolatba a támogatással.
404	Ismeretlen vagy lejárt munka.	Ha szükséges, hozzon létre egy új feladatot.
429	Kérés vagy aktív feladat limit elérve.	Becsület `retry_after_seconds`.
503	Sor/kapacitás vagy upstream ideiglenesen nem elérhető.	Próbálja újra exponenciális visszalépéssel és jitterrel.

Üzemeltetési szerződés

A SocialVideoSaver áttekinti a tervezett hálózatközi keresletet, mielőtt korlátokat rendelne a jóváhagyott integrációhoz.

Használjon idempotens alkalmazáslogikát, és soha ne indítson párhuzamos feladatokat ugyanahhoz a felhasználói kattintáshoz.
A gyorsítótár oldja meg a metaadatokat röviden, de a aláírt letöltési URL-eket mindig lejártnak tekintse.
Használjon korlátozott exponenciális visszalépést jitterrel 429, 503 és újrapróbálható hibák.
Csak nyilvános vagy olyan médiafájlokat dolgozzon fel, amelyekhez Ön jogosult hozzáférni, és ne kerülje meg a DRM-et és a hozzáférés-vezérlést.
Tartsa meg a kérésazonosítókat és a feladatazonosítókat a privát működési naplókban. Ne naplózza szükségtelenül a beküldött URL-eket.

Az aktiválás az exploráció előtt a Schema hozzáférés kiindulópontja a SocialVideoSaver-en. Egy többforrásos nézet ezután bemutatja a hozzárendelt hitelesítést és elmagyarázza a dokumentált kérésformákat.

ÜZEMELTETŐ ÁLTAL ELLENŐRZÖTT HOZZÁFÉRÉS

Aktiválás a támogatáson keresztül

Összefoglalja a kereszt-hálózati terméket, a becsült havi keresletet és minden érintett közösségi szolgáltatót. A SocialVideoSaver csak a kért elemzési vagy munkaképességeket aktiválja, és a token helyett egy hash-t tárol.

Aktiválás kérése A kulcsok bérlői hatókörűek, visszavonhatók, és a Kapcsolatfelvételi űrlapon keresztül adhatóak ki. Névtelen parancsfájlok nem tudnak letöltő munkát végrehajtani.