Tylko podgląd — wymagana aktywacja

Twórz pobrania z DWTT

DWTT publikuje ten zarys integracji do planowania, a nie do anonimowego wykonania. Pomoc techniczna musi zatwierdzić przepływ pracy dla klipu przed wydaniem klucza o określonym zakresie i jego limitu ruchu.

DwttToolkitJSON przez HTTPSZadania asynchronicznePoświadczenia zakresowe

Szybki start

DWTT ułatwia skanowanie hosta API. Strona zaczyna się od danych uwierzytelniających aktywowanych przez wsparcie, przechodzi do przypisanego punktu końcowego dzierżawcy i jasno określa ścieżkę wywołania wyłącznie po stronie serwera.

URL dzierżawcyhttps://dwtt.app

UwierzytelnianieX-API-Key: pending_activation_…

Profil klientaDwttToolkit

Wersja APIv1

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

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

DWTT podchodzi do bezpieczeństwa danych uwierzytelniających poprzez serwerowe przechowywanie sekretów, a następnie bez osadzania w pakiecie po stronie klienta. Uproszczony przepływ pracy nie utrzymuje żadnych publicznych dzienników ani repozytoriów w jawnej formie.

Rozwiązywanie linku

DWTT sprawia, że operacja Resolve jest łatwa do przejrzenia. Strona zaczyna się od wykrywania źródła, przechodzi do formatów z jednego przesłanego adresu URL i jasno stwierdza, że nie ma wymyślonych wyników.

POST/v1/resolveZakres: rozwiązać

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

DWTT podchodzi do identyfikatora formatu poprzez zwróconą wartość bez zmian, a następnie do dostępności dla każdego linku. Uproszczony przepływ pracy nie ujawnia żadnej domyślnie zgadywanej etykiety jakości.

Tworzenie i śledzenie zadania pobierania

W DWTT asynchroniczne przygotowanie jest na pierwszym miejscu przy wyjaśnianiu tworzenia Job. Ten uproszczony przepływ pracy jest następnie realizowany za pomocą krótkiego żądania HTTP i kończy się ograniczonym wykonaniem przez worker.

POST/v1/jobsZakres: oferty pracy

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

1202 ZaakceptowanoSave task_ref.

2Status ankietyGET /v1/jobs/{task_ref} 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://dwtt.app/v1/jobs/TASK_REF \
  -H "X-API-Key: $DWTT_TOOL_TOKEN"

Aby wyjaśnić Job polling, DWTT oddziela początkowe oczekiwanie jednej sekundy od limitowanego backoffu. Usprawniony przepływ pracy nadaje tymczasowej podpisanej dostawie własne miejsce.

Błędy przewidywalne

Jedna koperta spoza zakresu 2xx jest punktem wyjścia dla kontraktu błędu w DWTT. Uproszczony przepływ pracy następnie prezentuje identyfikator zgłoszenia do wsparcia i wyjaśnia 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

DWTT ustawia limity ruchu podczas aktywacji, aby integracje klipów i sieci źródłowe nie były przeciążone.

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.

DWTT ułatwia szybkie przeglądanie dostępu do Schema. Strona zaczyna się od aktywacji przed eksploracją, przechodzi do przypisanej autoryzacji i jasno przedstawia udokumentowane kształty żądań.

DOSTOSOWANY DO OPERATORA DOSTĘP

Aktywacja poprzez wsparcie

Wyślij DWTT planowaną integrację, prawdopodobną wielkość żądań oraz docelowe sieci. Wspomnij, czy klient potrzebuje rozwiązywania, tworzenia zadań, czy obu tych opcji, aby można było zatwierdzić klucz o ograniczonym zakresie i wyświetlić go 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.