Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med Social Video Saver

SocialVideoSaver tillhandahåller detta nätverksövergripande schema för teknisk planering. Produktionsuppgifter förblir avstängda tills det föreslagna användningsfallet passerar en supportgranskning.

SocialSaverWorkspaceJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

Supportaktiverade referenser är startpunkten för API-värden på SocialVideoSaver. En flerkällvy presenterar sedan en tilldelad hyresgästandpunkt och förklarar en serverendast anropsväg.

Webbadress till klienthttps://socialvideosaver.com

AutentiseringX-API-Key: pending_activation_…

KlientprofilSocialSaverWorkspace

API-versionv1

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

SocialVideoSavers multi-source-vy granskar serversidans hemliga lagring för Credential-säkerhet. Det visar ingen klientbunt som bäddar in nästa och döljer inte några offentliga loggar eller förråd.

Lösa en länk

Källdetektering är startpunkten för Resolve-operationen på SocialVideoSaver. En flerkällvy presenterar sedan format från en inskickad URL och förklarar att inga påhittade utdata finns.

POST/v1/resolveOmfattning: lösa

Fält	Typ	Obligatoriskt	Beskrivning
`social_url`	HTTPS- URL	Ja	Offentlig eller auktoriserad mediesida att analysera.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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

SocialVideoSavers multi-source-vy granskar det returnerade värdet oförändrat för Format identifier. Det visar per-länk tillgänglighet nästa och döljer inte någon gissade kvalitetsmärkning.

Skapa och följ ett nedladdningsjobb

SocialVideoSaver närmar sig jobbskapande genom asynkron förberedelse, sedan en kort HTTP-begäran. Den multi-source view håller begränsad arbetstagare verkställande explicit.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`social_url`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`media_profile`	sträng	Ja	Ett exakt ID från lösningssvaret.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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 GodkändSpara delivery_job.

2OmröstningsstatusGET /v1/jobs/{delivery_job} med samma nyckel.

3KlarÖppna den signerade nedladdnings-URL:en.

Status	Betydelse	Klientåtgärd
`queued`	Antagen till den begränsade kön.	Rösta igen med fördröjning.
`extracting`	Uppdaterar källmetadata eller rutt.	Fortsätt med omröstningen.
`processing`	Laddar ner, remuxar eller slår ihop.	Visa serverns framsteg.
`ready`	Signerad nedladdning är tillgänglig.	Skicka URL:en till användaren.
`failed`	Terminal strukturerat fel.	Läs `error_code`. Försök igen endast när det rekommenderas.
`expired`	Tillfällig utdata togs bort.	Skapa ett nytt jobb.

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

SocialVideoSaver organiserar jobbpolling runt en sekunds initial väntetid. Dess multi-source-vy jämför capped backoff. Tillfälligt signerad leverans förblir den sista kontrollen.

Förutsägbara fel

I SocialVideoSaver kommer ett icke-2xx kuvert först när man förklarar felkontraktet. Den flerkällvyn följs av en supportförfrågnings-ID och avslutas med förutsägbar klienthantering.

{
  "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	Typisk betydelse	Åtgärd
400	Ogiltig URL, innehåll eller otillgängligt format.	Korrigera förfrågan. Lös igen för format.
401	Saknad, ogiltig, utgången eller felaktig nyckel med fel behörighet.	Kontrollera serverns autentiseringsuppgifter.
403	Hyresgäst- eller källpolicy avvisade förfrågan.	Bryt inte mot policyn. Kontakta support.
404	Okänt eller utgånget jobb.	Skapa ett nytt jobb om det är lämpligt.
429	Begäran eller aktivt jobbgräns uppnådd.	Heder `retry_after_seconds`.
503	Kö/kapacitet eller upstream tillfälligt otillgänglig.	Försök igen med exponentiell backoff och jitter.

Driftkontrakt

SocialVideoSaver granskar projicerade cross-nätverk efterfrågan innan du tilldelar gränser för den godkända integration.

Använd idempotent programlogik och starta aldrig dubbla jobb för samma användarklick.
Cache lösa metadata kort, men alltid behandla signerade nedladdning webbadresser som löper ut.
Använd begränsad exponentiell backoff med jitter för 429, 503 och omförsökbara fel.
Bearbeta endast offentliga medier eller medier som du har behörighet att komma åt. DRM och åtkomstkontroller kringgås inte.
Spara begäran-ID och jobb-ID i privata driftloggar. Logga inte inskickade webbadresser i onödan.

Aktivering före utforskning är utgångspunkten för Schema-åtkomst på SocialVideoSaver. En multi-source-vy presenterar sedan tilldelad autentisering och förklarar dokumenterade begäranformer.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Sammanfatta produkten över nätverken, beräknad månatlig efterfrågan och varje social leverantör inom räckvidd. SocialVideoSaver aktiverar endast de begärda analys- eller jobbkapaciteterna och lagrar en hash istället för token.

Begär aktivering av konto Nycklar är klientomfattande, återkalleliga och utfärdas via Kontaktformuläret. Anonyma skript kan inte utföra hämtningsarbete.