Tylko podgląd — wymagana aktywacja

Zbuduj pobieranie z Social Video Saver

Poświadczenia produkcyjne pozostają wyłączone, dopóki proponowany przypadek użycia nie przejdzie przeglądu wsparcia technicznego. Poświadczenia produkcyjne pozostają wyłączone, dopóki proponowany przypadek użycia nie przejdzie kontroli pomocy technicznej.

SocialSaverWorkspaceJSON przez HTTPSZadania asynchronicznePoświadczenia zakresowe

Szybki start

Poświadczenia aktywowane przez wsparcie to punkt wyjścia dla hosta API w SocialVideoSaver. Widok wieloźródłowy przedstawia przypisany punkt końcowy najemcy i wyjaśnia ścieżkę wywołania tylko na serwerze.

URL dzierżawcyhttps://socialvideosaver.com

UwierzytelnianieX-API-Key: pending_activation_…

Profil klientaSocialSaverWorkspace

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

Pokazuje, że żaden pakiet klienta nie osadza się obok i nie zasłania żadnych publicznych dzienników ani repozytoriów.

Rozwiązywanie linku

Wykrywanie źródła jest punktem startowym operacji Resolve na SocialVideoSaver. Widok wieloźródłowy następnie prezentuje formaty z jednego przesłanego URL i wyjaśnia brak wymyślonych wyników.

POST/v1/resolveZakres: rozwiązać

Field	Typ	Wymagane	Opis
`social_url`	Adres HTTPS	Tak	Strona publiczna lub autoryzowane media do analizy.
`tenant`	ciąg znaków	Nie	Przypisana domena dzierżawy. Zazwyczaj pomijany.

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

Widok wieloźródłowy SocialVideoSaver przegląda zwracaną wartość bez zmian dla identyfikatora formatu. Następnie pokazuje dostępność na link oraz nie zasłania etykiety jakości bez przypuszczeń.

Tworzenie i śledzenie zadania pobierania

SocialVideoSaver podchodzi do tworzenia zadania poprzez asynchroniczne przygotowanie, a następnie krótkie żądanie HTTP. Widok wielu źródeł utrzymuje ograniczone wykonywanie pracowników w sposób jawny.

POST/v1/jobsZakres: oferty pracy

Field	Typ	Wymagane	Opis
`social_url`	Adres HTTPS	Tak	To samo znormalizowane źródło złożone do rozwiązania.
`media_profile`	ciąg znaków	Tak	Dokładny identyfikator z odpowiedzi na żądanie rozpoznania.
`tenant`	ciąg znaków	Nie	Przypisana domena dzierżawy. Zazwyczaj pomijany.

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

2Status ankietyGET /v1/jobs/{delivery_job} tym samym kluczem.

3GotowiOtwórz podpisany adres URL pobierania.

Status	Znaczenie	Akcja klienta
`queued`	Przyjęty do ograniczonej kolejki.	Ankieta ponownie z backoff.
`extracting`	Odświeżanie metadanych źródłowych lub trasy.	Kontynuuj ankietowanie.
`processing`	Pobieranie, remiksowanie lub łączenie.	Wyświetlanie postępu serwera.
`ready`	Podpisane pobieranie jest dostępne.	Wyślij adres URL do użytkownika.
`failed`	Błąd struktury terminala.	Read `error_code`. Powtórz próbę tylko wtedy, gdy jest to zalecane.
`expired`	Tymczasowe wyjście zostało usunięte.	Utwórz nowe zadanie.

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

SocialVideoSaver organizuje odpytywanie zadań wokół jednej sekundy początkowego oczekiwania. Jego widok wielu źródeł porównuje ograniczone backoff.

Błędy przewidywalne

W SocialVideoSaver najpierw pojawia się jedna koperta nie-2xx podczas wyjaśniania kontraktu błędu. Ten widok wieloźródłowy zawiera identyfikator zgłoszenia wsparcia i kończy się przewidywalnym obsługiwaniem po stronie klienta.

{
  "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	Typowe znaczenie	Akcja
400	Nieprawidłowy adres URL, treść lub niedostępny format.	Popraw żądanie. Rozwiąż ponownie dla formatów.
401	Brakujący, nieprawidłowy, wygasły lub o niewłaściwym zakresie klucz.	Sprawdź poświadczenia po stronie serwera.
403	Polityka najemcy lub źródła odrzuciła żądanie.	Nie omijać zasad. Skontaktuj się z pomocą techniczną.
404	Nieznane lub wygasłe zadanie.	Utwórz nowe zadanie, jeśli to konieczne.
429	Osiągnięto limit żądań lub aktywnych zadań.	Honor `retry_after_seconds`.
503	Kolejka/pojemność lub źródło tymczasowo niedostępne.	Powtórz próbę z wykładniczym cofaniem i drganiami.

Kontrakt operacyjny

SocialVideoSaver sprawdza prognozowane zapotrzebowanie między sieciami przed przypisaniem limitów do zatwierdzonej integracji.

Używaj logiki aplikacji idempotent i nigdy nie uruchamiaj zduplikowanych zadań dla tego samego kliknięcia użytkownika.
Pamięć podręczna rozwiązuje metadane krótko, ale zawsze traktuje podpisane adresy URL pobierania jako wygasające.
Użyj ograniczonego wykładniczego opóźnienia z jitterem dla 429, 503 i błędów do ponownego próbowania.
Przetwarzaj tylko publiczne media lub media, do których masz uprawnienia dostępu. DRM i kontrole dostępu nie są omijające.
Przechowuj identyfikatory żądań i identyfikatory zadań w prywatnych dziennikach operacyjnych. Nie rejestruj niepotrzebnie przesłanych adresów URL.

Aktywacja przed eksploracją jest punktem wyjścia dla dostępu Schema na SocialVideoSaver. Widok wielu źródeł przedstawia następnie przypisane uwierzytelnienie i wyjaśnia udokumentowane kształty żądań.

DOSTOSOWANY DO OPERATORA DOSTĘP

Aktywacja poprzez wsparcie

Podsumuj produkt między sieciami, prognozowane miesięczne zapotrzebowanie oraz każdego dostawcę społecznościowego w zakresie.

Prośba o aktywację Klucze są ograniczone do dzierżawcy, odwołalne i wydawane za pośrednictwem formularza Kontakt. Anonimowe skrypty nie mogą wykonywać pracy pobierania.