Pouze náhled — vyžaduje aktivaci

Sestavte stahování s Social Video Saver

SocialVideoSaver poskytuje toto schéma napříč sítěmi pro technické plánování. Produkční přihlašovací údaje zůstanou vypnuté, dokud navrhovaný případ použití neprojde kontrolou podpory.

SocialSaverWorkspaceJSON přes HTTPSAsynchronní úlohyPověření s rozsahem

Rychlý start

Povolené přihlašovací údaje jsou výchozím bodem pro hostitele API na SocialVideoSaver. Následně zobrazení z více zdrojů představí přiřazený koncový bod tenanta a vysvětlí serverově pouze volanou cestu.

URL klientahttps://socialvideosaver.com

AutentizaceX-API-Key: pending_activation_…

Profil klientaSocialSaverWorkspace

Verze APIv1

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

Vícezdrojové zobrazení SocialVideoSaver kontroluje serverové ukládání tajemství z hlediska bezpečnosti přihlašovacích údajů. Ukazuje, že neprobíhá vkládání do klientského balíčku, a také nezamlžuje žádné veřejné logy ani repozitáře.

Vyřešit odkaz

Detekce zdroje je výchozím bodem pro operaci Resolve na SocialVideoSaver. Pohled na více zdrojů pak představuje formáty z jedné odeslané adresy URL a vysvětluje žádné vymyšlené výstupy.

POST/v1/resolveRozsah: vyřešit

Pole	Typ	Povinné	Popis
`social_url`	HTTPS	Ano	Veřejná nebo autorizovaná mediální stránka k analýze.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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

Vícezdrojové zobrazení SocialVideoSaver kontroluje vrácenou hodnotu beze změny pro identifikátor Formátu. Zobrazuje dostupnost u jednotlivých odkazů dále a nezakrývá žádný odhadovaný štítek kvality.

Vytvoření a sledování úlohy stahování

SocialVideoSaver přistupuje k vytváření úloh pomocí asynchronní přípravy a poté krátkého HTTP požadavku. Pohled s více zdroji zachovává explicitní omezené provádění pracovníků.

POST/v1/jobsRozsah: pracovní místa

Pole	Typ	Povinné	Popis
`social_url`	HTTPS	Ano	Stejný normalizovaný zdroj předložený k vyřešení.
`media_profile`	řetězec	Ano	Přesné ID z odpovědi na překlad.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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 PřijatoSave delivery_job.

2Stav hlasováníGET /v1/jobs/{delivery_job} se stejným klíčem.

3PřipravenOtevřete podepsanou adresu URL ke stažení.

Stav	Význam	Akce klienta
`queued`	Připuštěn do ohraničené fronty.	Anketa znovu s backoff.
`extracting`	Obnovování zdrojových metadat nebo trasy.	Pokračujte v hlasování.
`processing`	Stahování, remixování nebo slučování.	Zobrazit průběh serveru.
`ready`	Podepsané stažení je k dispozici.	Odešlete uživateli adresu URL.
`failed`	Chyba struktury terminálu.	Přečtěte si `error_code`Zkuste to znovu pouze v případě, že je to doporučeno.
`expired`	Dočasný výstup byl odstraněn.	Vytvořte novou úlohu.

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

SocialVideoSaver organizuje dotazování úloh kolem jednosekundového počátečního čekání. Jeho pohled na více zdrojů porovnává omezený backoff.

Předvídatelné chyby

V SocialVideoSaver se při vysvětlování smlouvy chyb nejprve uvádí jedno obálkové sdělení mimo rozsah 2xx. Tento pohled z více zdrojů pak pokračuje s ID žádosti o podporu a uzavírá se předvídatelným zpracováním na straně klienta.

{
  "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": "…"
}

Hypertext Transfer Protocol	Typický význam	Akce
400	Neplatná adresa URL, tělo nebo nedostupný formát.	Opravte požadavek. Znovu vyřešte formáty.
401	Chybějící, neplatný, vypršený nebo nesprávný rozsah klíče.	Zkontrolujte pověření na straně serveru.
403	Klient nebo zdrojové zásady požadavek zamítly.	Nepřekračujte pravidla. Kontaktujte podporu.
404	Neznámá nebo vypršela pracovní pozice.	V případě potřeby vytvořte novou úlohu.
429	Dosáhli jste limitu požadavků nebo aktivních úloh.	Honor `retry_after_seconds`.
503	Fronta/kapacita nebo upstream dočasně nedostupné.	Zkuste to znovu s exponenciálním zpětným odstupem a jitterem.

Provozní smlouva

SocialVideoSaver před přiřazením limitů schválené integraci předpovídá poptávku napříč sítěmi.

Používejte idempotentní aplikační logiku a nikdy nespouštějte duplicitní úlohy pro stejné uživatelské kliknutí.
Cache krátce vyřeší metadata, ale vždy považuje podepsané adresy URL ke stažení za vypršení platnosti.
Použijte ohraničený exponenciální backoff s jitter pro 429, 503 a opakovatelné chyby.
Zpracovávejte pouze veřejná média nebo média, ke kterým máte oprávnění. DRM a přístupová omezení nejsou obcházena.
ID požadavků a ID úloh uchovávejte v soukromých provozních protokolech. Nezapisujte do protokolů odeslané adresy URL zbytečně.

Aktivace před průzkumem je výchozím bodem pro přístup ke schématu na SocialVideoSaver. Zobrazení z více zdrojů pak předkládá přiřazené ověření a vysvětluje zdokumentované tvary požadavků.

PŘÍSTUP PŘEZKOUMANÝ OPERATOREM

Aktivace prostřednictvím podpory

Shrňte produkt pro více sítí, očekávanou měsíční poptávku a všechny zahrnuté sociální služby. SocialVideoSaver aktivuje pouze požadované funkce analýzy nebo úloh a místo samotného tokenu ukládá jeho hash.

Požádat o aktivaci Klíče jsou omezeny na klienta, lze je odvolat a vydávají se prostřednictvím kontaktního formuláře.