Kun prøveversion — aktivering kræves

Byg downloads med Social Video Saver

Produktionslegitimationsoplysninger forbliver deaktiveret, indtil den foreslåede brugssag gennemgår en supportgennemgang.

SocialSaverWorkspaceJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

Support-aktiverede legitimationsoplysninger er udgangspunktet for API-vært på SocialVideoSaver. En multi-source visning præsenterer derefter en tildelt lejer slutpunkt og forklarer en server-kun opkald sti.

Lejer- URLhttps://socialvideosaver.com

GodkendelseX-API-Key: pending_activation_…

Profil af klientSocialSaverWorkspace

Version af 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"}'

SocialVideoSaver's multi-kilde visning gennemgår server-side hemmelig lagring for legitimationssikkerhed. Den viser ingen klientpakkeindlejring næste og skjuler ikke offentlige logfiler eller arkiver.

Løsning af et link

Kildegenkendelse er udgangspunktet for Resolve-operationen på SocialVideoSaver. En multi-kilde visning præsenterer derefter formater fra en indsendt URL og forklarer, at der ikke er opfundet output.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrævet	Beskrivelse
`social_url`	HTTPS- URL	Ja	Offentlig eller autoriseret medieside at analysere.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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

SocialVideoSaver's multi-kilde visning gennemgår den returnerede værdi uændret for formatidentifikator. Den viser tilgængelighed pr. link næste og skjuler ikke nogen gættet kvalitetsmærkat.

Opret og følg et downloadjob

SocialVideoSaver nærmer Job skabelse gennem asynkron forberedelse, så en kort HTTP-anmodning. Den multi-source visning holder afgrænset arbejdstager udførelse eksplicit.

POST/v1/jobsOmfang: job

Felt	Type	Påkrævet	Beskrivelse
`social_url`	HTTPS- URL	Ja	Den samme normaliserede kilde indsendt til at løse.
`media_profile`	streng	Ja	Et nøjagtigt id fra forklaringssvaret.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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 AccepteretGem delivery_job.

2AfstemningsstatusGET /v1/jobs/{delivery_job} med samme nøgle.

3KlarÅbn den signerede download-URL.

Status	Betydning	Klienthandling
`queued`	Optaget i den afgrænsede kø.	Afstemning igen med tilbageslag.
`extracting`	Opdatering af kildemetadata eller rute.	Fortsæt med at stemme.
`processing`	Downloading, remuxing eller sammenlægning.	Vis server fremskridt.
`ready`	Signeret download er tilgængelig.	Send URL-adressen til brugeren.
`failed`	Terminal struktureret fejl.	Læs `error_code`. Prøv kun igen, når det anbefales.
`expired`	Midlertidig output blev fjernet.	Opret et nyt job.

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

SocialVideoSaver organiserer Job-afstemning omkring et sekunds initial ventetid. Dens multisource-visning sammenligner begrænset tilbageholdelse. Midlertidig underskrevet levering forbliver den endelige kontrol.

Forudsigelige fejl

I SocialVideoSaver kommer en ikke-2xx kuvert først, når fejlkontrakten forklares. Den multi-kilde visning følger med en supportanmodnings-ID og afsluttes med forudsigelig klienthåndtering.

{
  "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 betydning	Handling
400	Ugyldig URL, brødtekst eller utilgængeligt format.	Ret anmodningen. Prøv igen for formater.
401	Manglende, ugyldig, udløbet eller forkert områdenøgle.	Kontroller legitimationsoplysningerne på serversiden.
403	Lejer- eller kildepolitikken afviste anmodningen.	Omgå ikke politikken. Kontakt support.
404	Ukendt eller udløbet job.	Opret eventuelt et nyt job.
429	Grænsen for anmodninger eller aktive job er nået.	Ære `retry_after_seconds`.
503	Kø/kapacitet eller opstrøm midlertidigt utilgængelig.	Prøv igen med eksponentiel tilbagefald og jitter.

Driftskontrakt

SocialVideoSaver gennemgår projiceret efterspørgsel på tværs af netværk, før der tildeles grænser for den godkendte integration.

Brug idempotent programlogik, og start aldrig dublerede job for det samme brugerklik.
Cache løse metadata kortvarigt, men altid behandle underskrevne download URL'er som udløber.
Brug begrænset eksponentiel tilbagetrækning med jitter for 429, 503 og genforsøgbare fejl.
Behandl kun offentlige medier eller medier, du har tilladelse til at få adgang til. DRM og adgangskontroller omgås ikke.
Behold anmodnings-ID'er og job-ID'er i private driftslogfiler. Log ikke indsendte URL'er unødvendigt.

Aktivering før udforskning er udgangspunktet for skemaadgang på SocialVideoSaver. En multi-kilde visning præsenterer derefter tildelt autentificering og forklarer dokumenterede anmodningsformer.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Opsummer tværnetværksproduktet, forventet månedligt efterspørgsel og hver social udbyder i omfanget. SocialVideoSaver aktiverer kun de anmodede analyse- eller jobfunktioner og gemmer en hash i stedet for tokenet.

Anmod om aktivering Nøgler er lejerafgrænsede, kan tilbagekaldes og udstedes via kontaktformularen. Anonyme scripts kan ikke udføre downloaderarbejde.