Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med Social Video Saver

SocialVideoSaver gir dette kryssnettverksskjemaet for teknisk planlegging. Produksjonslegitimasjon forblir av til den foreslåtte brukstilfellet passerer en støttegjennomgang.

SocialSaverWorkspaceJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

Støtte-aktiverte legitimasjoner er startpunktet for API-vert på SocialVideoSaver. En flerkildevisning presenterer deretter en tildelt leietakerendepunkt og forklarer en server-only kallsti.

Leietaker-URLhttps://socialvideosaver.com

AutentiseringX-API-Key: pending_activation_…

KlientprofilSocialSaverWorkspace

API-versjonv1

# 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 sin flerkildevisning gjennomgår server-side hemmelig lagring for sikkerhet av legitimasjon. Den viser ingen klientpakkeinnbygging neste og skjuler ingen offentlige logger eller arkiver.

Løse en kobling

Kildedeteksjon er utgangspunktet for Resolve-operasjonen på SocialVideoSaver. En flerkildevisning presenterer deretter formater fra en innsendt URL og forklarer at ingen oppdiktede utdata finnes.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrevd	Beskrivelse
`social_url`	HTTPS-URL	Ja	Offentlig eller autorisert medieside å analysere.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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

SocialVideoSavers flerkildevisning vurderer den returnerte verdien uendret for formatidentifikator. Den viser tilgjengelighet per lenke neste og skjuler ikke etiketten for ingen antatt kvalitet.

Opprett og følg en nedlastingsjobb

SocialVideoSaver nærmer Job skapelse gjennom asynkron forberedelse, deretter en kort HTTP-forespørsel. Den multi-kilde visning holder avgrenset arbeider utførelse eksplisitt.

POST/v1/jobsOmfang: jobber

Felt	Type	Påkrevd	Beskrivelse
`social_url`	HTTPS-URL	Ja	Den samme normaliserte kilden innlevert for å løse.
`media_profile`	streng	Ja	En nøyaktig ID fra løsningssvaret.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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 AkseptertLagre@ action: button delivery_job.

2AvstemningsstatusGET /v1/jobs/{delivery_job} med samme nøkkel.

3KlarÅpne den signerte nedlastingsadressen.

Status	Betydning	Klienthandling
`queued`	Opptatt i den begrensede køen.	Avstemning igjen med baklengs.
`extracting`	Oppdaterer kildemetadata eller rute.	Fortsett å avstemme.
`processing`	Laster ned, remikser eller slår sammen.	Vis server fremgang.
`ready`	Signert nedlasting er tilgjengelig.	Send URL-adressen til brukeren.
`failed`	Terminalstrukturert feil.	Lest `error_code`Prøv på nytt bare når det anbefales.
`expired`	Midlertidig utgang ble fjernet.	Opprett en ny jobb.

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

SocialVideoSaver organiserer jobbavstemning rundt ett sekunds innledende ventetid. Dens multi-kildevisning sammenligner capped backoff. Midlertidig signert levering forblir den endelige sjekken.

Forutsigbare feil

I SocialVideoSaver kommer en ikke-2xx konvolutt først når Feilkontrakt forklares. Den flerkildevisningen følger med en støtteforespørsels-ID og avsluttes med forutsigbar 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 utilgjengelig format.	Rett opp forespørselen. Løs igjen for formater.
401	Manglende, ugyldig, utløpt eller feil omfang nøkkel.	Sjekk server-side legitimasjon.
403	Leietaker eller kildepolicy avslo forespørselen.	Ikke omgå policyen. Kontakt kundestøtte.
404	Ukjent eller utløpt jobb.	Opprett en ny jobb om det er passende.
429	Grensen for forespørsler eller aktive jobber er nådd.	Ære `retry_after_seconds`.
503	Kø/kapasitet eller oppstrøms midlertidig utilgjengelig.	Prøv igjen med eksponentiell tilbakeslag og jitter.

Driftskontrakt

SocialVideoSaver gjennomgår projisert etterspørsel på tvers av nettverk før du tilordner grenser til den godkjente integrasjonen.

Bruk idempotent programlogikk og aldri starte dupliserte jobber for samme bruker klikk.
Cache løse metadata kort, men alltid behandle signerte nedlastingsadresser som utløper.
Bruk begrenset eksponentiell tilbakeslag med jitter for 429, 503 og gjentatte feil.
Behandle bare offentlige medier eller medier du har autorisert tilgang til. DRM og tilgangskontroller omgås ikke.
Oppbevar forespørsels-ID-er og jobb-ID-er i private driftslogger. Ikke logg innsendte URL-er unødvendig.

Aktivering før utforskning er startpunktet for Skjema-tilgang på SocialVideoSaver. En flerkildevisning presenterer deretter tildelt autentisering og forklarer dokumenterte forespørselsformer.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Oppsummer tvers over nettverket produktet, forventet månedlig etterspørsel og alle sosiale leverandører innenfor omfanget. SocialVideoSaver aktiverer kun de forespurte analyse- eller jobbfunksjonene og lagrer en hash i stedet for tokenet.

Be om aktivering Nøklene er basert på leietakers omfang, kan tilbakekalles og utstedes via Kontaktskjemaet.