Tylko podgląd — wymagana aktywacja

Buduj pobrania z FFast

FFast udostępnia zamierzony kształt API bez włączania publicznych wywołań. Operator aktywuje poświadczenia i mierzone limity po zbadaniu proponowanej integracji.

FfastPipelineJSON przez HTTPSZadania asynchronicznePoświadczenia zakresowe

Szybki start

FFast uzyskuje dostęp do hosta API za pomocą poświadczeń aktywowanych przez wsparcie, a następnie przypisanego punktu końcowego najemcy. Szybka recenzja utrzymuje wyraźną ścieżkę wywołania tylko na serwerze.

URL dzierżawcyhttps://ffast.app

UwierzytelnianieX-API-Key: pending_activation_…

Profil klientaFfastPipeline

Wersja APIv1

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

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

Dla bezpieczeństwa poświadczeń FFast sprawdza serwerowe przechowywanie sekretów przed brakiem osadzania pakietu klienta. Ta szybka weryfikacja również zapewnia brak publicznych logów czy repozytoriów.

Rozwiązywanie linku

FFast podchodzi do operacji Resolve poprzez wykrywanie źródła, a następnie formatuje z jednego przesłanego URL-a. Szybka recenzja nie zawiera jawnych wymyślonych wyników.

POST/v1/resolveZakres: rozwiązać

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

Dla identyfikatora formatu FFast sprawdza zwróconą wartość bez zmian przed dostępnością per-link. Ta szybka recenzja również nie ujawnia żadnej zgadywanej etykiety jakości.

Tworzenie i śledzenie zadania pobierania

FFast obsługuje tworzenie zadania, najpierw identyfikując asynchroniczne przygotowanie. Następnie wykonuje krótkie żądanie HTTP i utrzymuje kontrolę nad ograniczonym wykonaniem pracownika.

POST/v1/jobsZakres: oferty pracy

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

1202 ZaakceptowanoSave pipeline_run.

2Status ankietyGET /v1/jobs/{pipeline_run} 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://ffast.app/v1/jobs/PIPELINE_RUN \
  -H "X-API-Key: $FFAST_PIPELINE_KEY"

Sondaż zadania rozpoczyna się od jednosekundowe początkowe oczekiwanie na FFast. Następny widok obejmuje ograniczone backoff. Strona utrzymuje tymczasowe podpisane dostawy widoczne.

Błędy przewidywalne

Szybka recenzja FFast ocenia jedną kopertę nie-2xx dla kontraktu błędu. Pokazuje identyfikator zgłoszenia wsparcia i nie zaciera przewidywalnej obsługi 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

FFast aktywuje mierzone limity, które utrzymują przekazywanie w gotowości bez umieszczania niebezpiecznego obciążenia na platformach wyższego rzędu.

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.

FFast uzyskuje dostęp do schematu poprzez aktywację przed eksploracją, a następnie przypisaną autoryzację. Szybka recenzja utrzymuje wyraźne udokumentowane kształty żądań.

DOSTOSOWANY DO OPERATORA DOSTĘP

Aktywacja poprzez wsparcie

Podaj FFast zwięzłe podsumowanie produktu, prognozę ruchu i listę platform. Określ, czy potrzebne są kontrole metadanych, przygotowane zadania, czy oba, aby wydany klucz odpowiadał rzeczywistemu przepływowi pracy.

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.