Alleen voorbeeld — activering vereist

Bouw downloads met Social Video Saver

SocialVideoSaver biedt dit netwerkoverschrijdende schema voor technische planning. Productie-inloggegevens blijven uitgeschakeld totdat de voorgestelde use case een ondersteuningsbeoordeling doorstaat.

SocialSaverWorkspaceVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik

Snel aan de slag

Een weergave met meerdere bronnen presenteert vervolgens een toegewezen eindpunt van de tenant en legt een oproeppad uit dat alleen op de server wordt uitgevoerd.

URL van tenanthttps://socialvideosaver.com

AuthenticatieX-API-Key: pending_activation_…

Profiel van de klantSocialSaverWorkspace

API-versiev1

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

De multi-source weergave van SocialVideoSaver bekijkt server-side geheime opslag voor Credential veiligheid. Het toont vervolgens geen client bundle embedding en verbergt geen openbare logs of repositories.

Een koppeling oplossen

Brondetectie is het startpunt voor de Resolve-bewerking op SocialVideoSaver. Een weergave met meerdere bronnen presenteert vervolgens formaten van één ingediende URL en legt geen verzonnen uitvoer uit.

POST/v1/resolveToepassingsgebied: oplossen

Veld	Type	Vereist	Beschrijving
`social_url`	HTTPS-URL	Ja.	Openbare of geautoriseerde mediapagina om te analyseren.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

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

De weergave van SocialVideoSaver met meerdere bronnen beoordeelt de geretourneerde waarde onveranderd voor de formaat-id. Het toont de beschikbaarheid per link erna en verbergt geen vermoedelijke kwaliteitslabel.

Maak en volg een downloadtaak

SocialVideoSaver benadert het aanmaken van taken via asynchrone voorbereiding, vervolgens een kort HTTP-verzoek en vervolgens een lang HTTP-verzoek.

POST/v1/jobsScope: vacatures

Veld	Type	Vereist	Beschrijving
`social_url`	HTTPS-URL	Ja.	Dezelfde genormaliseerde bron ingediend om op te lossen.
`media_profile`	tekenreeks	Ja.	Een exacte ID uit de resolve-respons.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

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

2Poll status 1GET /v1/jobs/{delivery_job} met dezelfde sleutel.

3KlaarOpen de ondertekende download-URL.

Status	Betekenis	Actie van de klant
`queued`	Toegestaan in de beperkte wachtrij.	Poll weer met achteruit.
`extracting`	Bronmetadata of route vernieuwen.	Ga door met pollen.
`processing`	Bezig met downloaden, remuxen of samenvoegen.	Toon server voortgang.
`ready`	Ondertekende download is beschikbaar.	Stuur de URL naar de gebruiker.
`failed`	Terminal gestructureerde fout.	Lees `error_code`Probeer het alleen opnieuw als dat wordt geadviseerd.
`expired`	Tijdelijke uitvoer werd verwijderd.	Maak een nieuwe taak aan.

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

SocialVideoSaver organiseert de polling van taken rond een initiële wachttijd van één seconde. De weergave met meerdere bronnen vergelijkt de maximale backoff.

Voorspelbare fouten

In SocialVideoSaver komt één niet-2xx-envelop eerst wanneer het Foutcontract wordt uitgelegd. Die multi-source view volgt met een supportaanvraag-ID en sluit op voorspelbare clientafhandeling.

{
  "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	Typische betekenis	Actie
400	Ongeldige URL, body of niet beschikbare indeling.	Corrigeer de aanvraag. Los opnieuw op voor formaten.
401	Ontbrekende, ongeldige, verlopen of verkeerd bereik sleutel.	Controleer de serverzijde referentie.
403	Tenant of bronbeleid heeft de aanvraag afgewezen.	Omzeil het beleid niet. Neem contact op met de ondersteuning.
404	Onbekende of verlopen vacature.	Maak indien nodig een nieuwe taak aan.
429	Aanvraag- of actieve-taaklimiet bereikt.	Eer `retry_after_seconds`.
503	Wachtrij/capaciteit of upstream tijdelijk niet beschikbaar.	Probeer het opnieuw met exponentiële backoff en jitter.

Operationeel contract

SocialVideoSaver beoordeelt de verwachte vraag over meerdere netwerken voordat er limieten worden toegewezen aan de goedgekeurde integratie.

Gebruik idempotente toepassingslogica en start nooit dubbele taken voor dezelfde gebruikersklik.
Cache lost metadata kort op, maar behandelt ondertekende download-URL's altijd als verlopen.
Gebruik begrensde exponentiële backoff met jitter voor 429, 503 en herprobeerbare fouten.
Verwerk alleen openbare media of media waarvoor u toegangsrechten hebt, en vermijd het omzeilen van DRM en toegangscontrole.
Bewaar verzoek-ID's en taak-ID's in privé-operationele logboeken. Log niet onnodig verzonden URL's.

Activering voor exploratie is het startpunt voor Schema-toegang op SocialVideoSaver. Een weergave met meerdere bronnen presenteert vervolgens toegewezen authenticatie en legt gedocumenteerde aanvraagvormen uit.

DOOR DE OPERATOR BEHEERDE TOEGANG

Activeren via ondersteuning

Vat het cross-netwerk product, de geprojecteerde maandelijkse vraag en elke sociale aanbieder binnen de scope samen. SocialVideoSaver activeert alleen de gevraagde analyse- of taakmogelijkheden en slaat een hash op in plaats van de token.

Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.