Tylko podgląd — wymagana aktywacja

Zbuduj pobieranie z downf.io

DownF utrzymuje wyłączenie wykonania API do czasu, aż operator przejrzy przypadek użycia zgodności. Przykłady opisują planowaną umowę, podczas gdy prawdziwe dane uwierzytelniające i limity pojawiają się tylko poprzez aktywację wsparcia.

DownfBridgeJSON przez HTTPSZadania asynchronicznePoświadczenia zakresowe

Szybki start

DownF organizuje host API wokół poświadczeń aktywowanych wsparciem. Jego widok zgodności porównuje przypisany punkt końcowy najemcy. Ścieżka wywołania tylko serwera pozostaje ostateczną kontrolą.

URL dzierżawcyhttps://downf.io

UwierzytelnianieX-API-Key: pending_activation_…

Profil klientaDownfBridge

Wersja APIv1

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

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

Bezpieczeństwo poświadczeń zaczyna się od przechowywania sekretów po stronie serwera na DownF. Ten widok zgodności nie prezentuje osadzania pakietu klienta. Ostatecznym faktem jest brak publicznych logów lub repozytoriów.

Rozwiązywanie linku

DownF organizuje operację Resolve wokół wykrywania źródła. Jego widok zgodności porównuje formaty z jednego przesłanego URL. Brak wymyślonych wyników pozostaje ostateczną kontrolą.

POST/v1/resolveZakres: rozwiązać

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

Identyfikator formatu zaczyna się od zwróconej wartości niezmienionej w DownF. Ten widok zgodności następnie prezentuje dostępność na link. Ostatecznym faktem jest brak zgadywanej etykiety jakości.

Tworzenie i śledzenie zadania pobierania

Tworzenie zadania zaczyna się od asynchronicznego przygotowania na DownF. Następny widok obejmuje krótkie żądanie HTTP. Strona utrzymuje widoczne ograniczone wykonywanie pracownika.

POST/v1/jobsZakres: oferty pracy

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

1202 ZaakceptowanoSave transfer_ref.

2Status ankietyGET /v1/jobs/{transfer_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://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

Widok zgodności DownF ocenia jednosekundowe początkowe oczekiwanie na odpytywanie zadań. Pokazuje ograniczone opóźnienie i nie zaciemnia tymczasowej podpisanej dostawy.

Błędy przewidywalne

DownF przedstawia trzy praktyczne punkty dotyczące kontraktu błędu. Pierwszy to jedna koperta nie-2xx. Widok zgodności obejmuje następnie identyfikator żądania wsparcia. Ostatni punkt to przewidywalne obsługiwanie 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

DownF ustala limit żądań po przejrzeniu docelowego klienta, utrzymując stabilność swoich kontroli kompatybilności i dostawców upstream.

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.

DownF organizuje dostęp do Schemy wokół aktywacji przed eksploracją. Jego widok zgodności porównuje przypisaną autoryzację. Udokumentowane kształty żądań pozostają ostateczną kontrolą.

DOSTOSOWANY DO OPERATORA DOSTĘP

Aktywacja poprzez wsparcie

Opisz produkt, przewidź jego miesięczne wywołania i wymień platformy, które musi analizować. Wsparcie DownF potwierdzi wymagane zakresy przed wydaniem jednorazowego widocznego poświadczenia, którego przechowywana kopia to tylko hash.

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.