Solo anteprima — attivazione richiesta

Costruire i download con Social Video Saver

SocialVideoSaver fornisce questo schema cross-network per la pianificazione tecnica. Le credenziali di produzione rimangono disattivate finché il caso d'uso proposto non supera una revisione di supporto.

SocialSaverWorkspaceJSON su HTTPSLavori asincroniCredenziali con ambito

Quick start

Le credenziali attivate dal supporto sono il punto di partenza per l'host API su SocialVideoSaver. Una vista multi-sorgente presenta quindi un endpoint tenant assegnato e spiega un percorso di chiamata solo server.

URL del tenanthttps://socialvideosaver.com

AutenticazioneX-API-Key: pending_activation_…

Profilo del clienteSocialSaverWorkspace

Versione dell'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"}'

La vista multi-sorgente di SocialVideoSaver esamina l'archiviazione segreta lato server per la sicurezza delle Credenziali. Non mostra alcun embedding del bundle client successivamente e non oscura log pubblici o repository.

Risolvere un collegamento

Il rilevamento della sorgente è il punto di partenza per l'operazione di Risoluzione su SocialVideoSaver. Una vista multi-sorgente presenta quindi i formati da un URL inviato e spiega l'assenza di output inventati.

POST/v1/resolveAmbito di applicazione: risolvere

Campo	Tipo	Obbligatorio	Descrizione
`social_url`	URL HTTPS	Sì	Pagina media pubblica o autorizzata da analizzare.
`tenant`	stringa	No.	Dominio tenant assegnato. In genere omesso.

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

La vista multi-sorgente di SocialVideoSaver esamina il valore restituito invariato per l'identificatore del formato. Mostra la disponibilità per link successivamente e non oscura l'etichetta di qualità non ipotizzata.

Creare e seguire un processo di download

SocialVideoSaver affronta la creazione di Job tramite preparazione asincrona, seguita da una breve richiesta HTTP. La vista multi-sorgente mantiene esplicita l'esecuzione limitata dei worker.

POST/v1/jobsAmbito: posti di lavoro

Campo	Tipo	Obbligatorio	Descrizione
`social_url`	URL HTTPS	Sì	La stessa fonte normalizzata è stata inviata per la risoluzione.
`media_profile`	stringa	Sì	Un ID esatto dalla risposta di risoluzione.
`tenant`	stringa	No.	Dominio tenant assegnato. In genere omesso.

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

2Stato del sondaggioGET /v1/jobs/{delivery_job} con la stessa chiave.

3ProntoAprire l'URL di download firmato.

Stato	Significato	Azione del cliente
`queued`	Ammesso alla coda limitata.	Sondaggio di nuovo con backoff.
`extracting`	Aggiornamento dei metadati di origine o della rotta.	Continua a sondare.
`processing`	Scaricare, remux o unire.	Visualizza il progresso del server.
`ready`	Il download firmato è disponibile.	Invia l'URL all'utente.
`failed`	Errore strutturato terminale.	Leggi `error_code`Riprova solo quando ti viene consigliato.
`expired`	L'uscita temporanea è stata rimossa.	Creare un nuovo lavoro.

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

SocialVideoSaver organizza il polling dei Job attorno a un'attesa iniziale di un secondo. La sua vista multi-sorgente confronta il backoff limitato. La consegna temporanea firmata rimane il controllo finale.

Errori prevedibili

In SocialVideoSaver, un envelope non-2xx viene presentato per primo quando si spiega il contratto di Errore. Questa vista multi-sorgente segue con un ID di richiesta di supporto e si chiude su una gestione prevedibile del client.

{
  "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	Significato tipico	Azione
400	URL, corpo o formato non valido.	Correggi la richiesta. Risolvi di nuovo per i formati.
401	Chiave mancante, non valida, scaduta o con ambito errato.	Verificare le credenziali lato server.
403	Criterio di tenant o di origine ha rifiutato la richiesta.	Non aggirare la politica. Contattare l'assistenza.
404	Offerta di lavoro sconosciuta o scaduta.	Creare un nuovo lavoro, se del caso.
429	Richiesta o limite di lavori attivi raggiunto.	Onore `retry_after_seconds`.
503	Coda/capacità o upstream temporaneamente non disponibile.	Riprova con backoff esponenziale e jitter.

Contratto operativo

SocialVideoSaver valuta la domanda prevista tra le reti prima di assegnare limiti all'integrazione approvata.

Usa una logica applicativa idempotente e non avviare mai lavori duplicati per lo stesso clic dell'utente.
Memorizza brevemente i metadati di risoluzione, ma considera sempre le URL di download firmate come scadute.
Usa il backoff esponenziale limitato con jitter per 429, 503 e errori riprovabili.
Elabora solo media pubblici o media a cui sei autorizzato ad accedere. DRM e controlli di accesso non vengono bypassati.
Conserva gli ID delle richieste e gli ID dei lavori nei registri operativi privati. Non registrare inutilmente gli URL inviati.

L'attivazione prima dell'esplorazione è il punto di partenza per l'accesso allo Schema su SocialVideoSaver. Una vista multi-sorgente presenta quindi l'autenticazione assegnata e spiega le forme di richiesta documentate.

ACCESSO REVISO DALL'OPERATORE

Attivazione tramite supporto

Riepiloga il prodotto cross-network, la domanda mensile prevista e ogni fornitore social in ambito. SocialVideoSaver attiva solo le capacità di analisi o lavoro richieste e memorizza un hash invece del token.

Richiedi attivazione Le chiavi sono limitate all'inquilino, revocabili e rilasciate tramite il modulo di contatto. Gli script anonimi non possono eseguire lavori di download.