Tylko podgląd — wymagana aktywacja

Buduj pobrania za pomocą SaveTK

SaveTK wyświetla plan API dla integracji narzędzi dla twórców, ale nie akceptuje wykonywania bez uwierzytelnienia. Zatwierdzenie dostarcza zarówno klucz, jak i jego limity działania.

SaveTkCreatorJSON przez HTTPSZadania asynchronicznePoświadczenia zakresowe

Szybki start

SaveTK przedstawia trzy praktyczne punkty dotyczące hosta API. Najpierw jest obsługa aktywowanych poświadczeń. Następnie przepływ zapisu obejmuje przypisany punkt końcowy dzierżawcy. Jego ostatnim punktem jest ścieżka wywołania wyłącznie po stronie serwera.

URL dzierżawcyhttps://savetk.app

UwierzytelnianieX-API-Key: pending_activation_…

Profil klientaSaveTkCreator

Wersja APIv1

# Available only after support activation
export SAVETK_CREATOR_KEY="issued-after-review"

curl -X POST https://savetk.app/v1/resolve \
  -H "X-API-Key: $SAVETK_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'

SaveTK ułatwia skanowanie bezpieczeństwa poświadczeń. Strona zaczyna się od serwerowego przechowywania tajnych danych, przechodzi do braku osadzania pakietu po stronie klienta i jasno stwierdza brak publicznych dzienników lub repozytoriów.

Rozwiązywanie linku

SaveTK przedstawia trzy praktyczne punkty dotyczące obsługi Resolve. Najpierw jest wykrywanie źródła. Następnie przepływ zapisu obejmuje formaty z jednego przesłanego adresu URL. Ostatni punkt to brak wymyślonych wyników.

POST/v1/resolveZakres: rozwiązać

Field	Typ	Wymagane	Opis
`creator_link`	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
}

SaveTK sprawia, że identyfikator formatu jest łatwy do zeskanowania. Strona zaczyna się od zwróconej wartości bez zmian, przechodzi do dostępności dla poszczególnych linków i wyraźnie stwierdza brak zgadywanej etykiety jakości.

Tworzenie i śledzenie zadania pobierania

Tworzenie zadania rozpoczyna się od asynchronicznego przygotowania na SaveTK. Ten proces zapisu następnie przedstawia krótkie żądanie HTTP. Ostatecznym faktem jest ograniczone wykonywanie przez pracownika.

POST/v1/jobsZakres: oferty pracy

Field	Typ	Wymagane	Opis
`creator_link`	Adres HTTPS	Tak	To samo znormalizowane źródło złożone do rozwiązania.
`save_option`	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://savetk.app/v1/jobs \
  -H "X-API-Key: $SAVETK_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_link":"https://www.youtube.com/watch?v=VIDEO_ID","save_option":"18"}'

1202 ZaakceptowanoSave save_task.

2Status ankietyGET /v1/jobs/{save_task} 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://savetk.app/v1/jobs/SAVE_TASK \
  -H "X-API-Key: $SAVETK_CREATOR_KEY"

SaveTK obsługuje odpytywanie zadań, najpierw identyfikując jednosekundowe początkowe oczekiwanie, a następnie z ograniczoną liczbą odstępów i utrzymując tymczasowe podpisane dostarczanie w widoku.

Błędy przewidywalne

Kontrakt błędu zaczyna się od jednej koperty spoza 2xx na SaveTK. Następny widok obejmuje identyfikator zgłoszenia do pomocy technicznej. Strona utrzymuje widoczną przewidywalną obsługę 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

SaveTK ustala uprawnienia przepływu pracy twórcy po zbadaniu oczekiwanego ruchu i platform publikacyjnych w zakresie.

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.

SaveTK przedstawia trzy praktyczne punkty dotyczące dostępu do Schema. Najpierw jest aktywacja przed eksploracją. Następnie przepływ zapisu obejmuje przypisane uwierzytelnianie. Jego ostatnim punktem są udokumentowane struktury żądań.

DOSTOSOWANY DO OPERATORA DOSTĘP

Aktywacja poprzez wsparcie

Określ, co robi klient SaveTK, ile wywołań oczekuje i które usługi publikowania są niezbędne. Przegląd wsparcia wybiera jego zakresy, a następnie zwraca nieodwracalne poświadczenie wyświetlane tylko raz.

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.