Numai previzualizare — activare necesară

Construiți descărcări cu Social Video Saver

SocialVideoSaver oferă această schemă cross-network pentru planificare tehnică. Datele de autentificare de producție rămân dezactivate până când cazul de utilizare propus trece de o analiză a suportului.

SocialSaverWorkspaceJSON prin HTTPSLocuri de muncă asincroneAcreditări cu domeniu

Start rapid

Datele de autentificare activate pentru suport reprezintă punctul de plecare pentru gazda API pe SocialVideoSaver. O vizualizare cu surse multiple prezintă apoi un endpoint de tenant atribuit și explică o cale de apel doar de server.

URL- ul entității găzduitehttps://socialvideosaver.com

AutentificareX-API-Key: pending_activation_…

Profilul de clientSocialSaverWorkspace

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

Vizualizarea din surse multiple a SocialVideoSaver verifică stocarea secretelor pe server pentru siguranța acreditărilor. Arată că următorul nu este integrat în pachetul client și nu ascunde nici jurnalele publice, nici depozitele.

Rezolvarea unui link

Detectarea sursei este punctul de plecare pentru funcționarea Resolve pe SocialVideoSaver. O vizualizare multi-sursă prezintă apoi formatele dintr-un singur URL trimis și explică faptul că nu există rezultate inventate.

POST/v1/resolveScop: rezolva

Câmp	Tip	Obligatoriu	Descrierea
`social_url`	URL HTTPS	Da.	Pagina media publică sau autorizată pentru a analiza.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei omis.

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

Vizualizarea multi-sursă a SocialVideoSaver verifică valoarea returnată neschimbată pentru identificatorul Format. Afișează disponibilitatea pentru fiecare link în continuare și nu ascunde nicio etichetă de calitate ghicită.

Crearea și urmărirea unei lucrări de descărcare

SocialVideoSaver abordează crearea Jobului prin pregătire asincronă, apoi printr-o scurtă cerere HTTP. Vizualizarea multi-sursă păstrează explicită execuția limitată a lucrătorilor.

POST/v1/jobsDomeniul de aplicare: locuri de muncă

Câmp	Tip	Obligatoriu	Descrierea
`social_url`	URL HTTPS	Da.	Aceeași sursă normalizată prezentată pentru a rezolva.
`media_profile`	șir	Da.	Un ID exact din răspunsul de rezolvare.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei omis.

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 AcceptatSalvează delivery_job.

2Starea sondajuluiGET /v1/jobs/{delivery_job} cu aceeași cheie.

3Gata.Deschideți URL-ul de descărcare semnat.

Starea	Semnificație	Acțiune de client
`queued`	Admis în coada limitată.	Sondaj din nou cu backoff.
`extracting`	Reîmprospătarea metadatelor sursă sau a rutei.	Continuă să votezi.
`processing`	Descărcarea, remixarea sau îmbinarea.	Afișați progresul serverului.
`ready`	Descărcarea semnată este disponibilă.	Trimiteți URL-ul utilizatorului.
`failed`	Eroare structurată terminală.	Citiți `error_code`. Reîncercaţi numai atunci când este recomandat.
`expired`	Ieșirea temporară a fost eliminată.	Creați un loc de muncă nou.

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

SocialVideoSaver organizează interogarea Job în jurul unei așteptări inițiale de o secundă. Vizualizarea sa multi-sursă compară backoff-ul plafonat. Livrarea temporară semnată rămâne verificarea finală.

Erori previzibile

În SocialVideoSaver, un singur plic non-2xx apare primul când se explică contractul de eroare. Acea vedere din surse multiple este urmată de un ID al solicitării de suport și se încheie cu gestionarea previzibilă de către 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	Semnificație tipică	Acțiune
400	URL nevalid, corp sau format indisponibil.	Corectați solicitarea. Rezolvați din nou pentru formate.
401	Cheie lipsă, nevalidă, expirată sau cu domeniu incorect.	Verificați acreditările de pe partea serverului.
403	Politica chiriașului sau a sursei a respins solicitarea.	Nu ocoliți politica. Contactați asistența.
404	Loc de muncă necunoscut sau expirat.	Creați un nou loc de muncă, dacă este cazul.
429	A fost atinsă limita de solicitări sau de lucrări active.	Onoare. `retry_after_seconds`.
503	Coada/capacitatea sau sursa din amonte sunt temporar indisponibile.	Reîncercați cu backoff exponențial și jitter.

Contract de exploatare

SocialVideoSaver a analizat cererea proiectată pe mai multe rețele înainte de a atribui limite integrării aprobate.

Folosiți logică de aplicație idempotentă și nu porniți niciodată joburi duplicate pentru același clic al utilizatorului.
Stocați temporar metadatele rezolvate în cache, dar tratați întotdeauna URL-urile semnate de descărcare ca expirabile.
Utilizați backoff exponențial limitat cu jitter pentru 429, 503 şi erori reîncercabile.
Procesează doar media publică sau media la care ești autorizat să ai acces. DRM și controalele de acces nu sunt ocolite.
Păstrați ID-urile cererilor și ID-urile joburilor în jurnalele operaționale private. Nu înregistrați inutil URL-urile trimise.

Activarea înaintea explorării este punctul de plecare pentru accesul la Schema pe SocialVideoSaver. Apoi, o vizualizare din mai multe surse prezintă autentificarea atribuită și explică formele de solicitare documentate.

ACCES REVIZUIT DE OPERATOR

Activați prin asistență

Rezumați produsul cross-network, cererea lunară proiectată și fiecare furnizor social din domeniu. SocialVideoSaver activează doar capacitățile de analiză sau de job solicitate și stochează un hash în locul tokenului.

Solicitați activarea Cheile sunt limitate la nivel de chiriaș, pot fi revocate și sunt emise prin formularul de contact. Scripturile anonime nu pot executa sarcini de descărcare.