https://easyf.appTwórz pobrania za pomocą EasyF
EasyF pokazuje interfejs z wyprzedzeniem, dzięki czemu programiści mogą oszacować swoją pracę. Przed utworzeniem klucza live i granicy użycia nadal wymagana jest weryfikacja wsparcia.
EasyfClientJSON przez HTTPSZadania asynchronicznePoświadczenia zakresowe
01
Szybki start
Aby wyjaśnić host API, EasyF oddziela poświadczenia aktywowane przez wsparcie od przypisanego punktu końcowego najemcy. Przepływ pracy w prostym języku daje ścieżce wywołania tylko po stronie serwera własne miejsce.
X-API-Key: pending_activation_…EasyfClientv1# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"
curl -X POST https://easyf.app/v1/resolve \
-H "X-API-Key: $EASYF_SERVICE_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'Bezpieczeństwo poświadczeń zaczyna się od przechowywania tajemnic po stronie serwera na EasyF. Następny widok obejmuje brak osadzania pakietu po stronie klienta. Strona nie udostępnia publicznie żadnych logów ani repozytoriów.
02
Rozwiązywanie linku
Aby wyjaśnić działanie Resolve, EasyF oddziela wykrywanie źródła od formatów z jednego przesłanego adresu URL. Przebieg w prostym języku nie nadaje własnego miejsca żadnym wymyślonym wynikom.
POST
/v1/resolveZakres: rozwiązać| Field | Typ | Wymagane | Opis |
|---|---|---|---|
asset_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
}Identyfikator formatu zaczyna się od zwróconej wartości bez zmian na EasyF. Następny widok obejmuje dostępność dla każdego łącza. Strona nie pokazuje żadnej zgadywanej etykiety jakości.
03
Tworzenie i śledzenie zadania pobierania
EasyF przedstawia trzy praktyczne punkty dotyczące tworzenia zadań. Pierwszy to przygotowanie asynchroniczne. Następnie prosty przepływ pracy obejmuje krótkie żądanie HTTP. Ostatnim punktem jest ograniczone wykonywanie przez pracowników.
POST
/v1/jobsZakres: oferty pracy| Field | Typ | Wymagane | Opis |
|---|---|---|---|
asset_url | Adres HTTPS | Tak | To samo znormalizowane źródło złożone do rozwiązania. |
variant_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://easyf.app/v1/jobs \
-H "X-API-Key: $EASYF_SERVICE_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'delivery_id.GET /v1/jobs/{delivery_id} tym samym kluczem.| 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://easyf.app/v1/jobs/DELIVERY_ID \
-H "X-API-Key: $EASYF_SERVICE_KEY"EasyF wykorzystuje odpytywanie zadań z początkowym jednosekundowym oczekiwaniem, a następnie z ograniczonym wykładniczym opóźnieniem. Przepływ pracy opisany prostym językiem jasno uwzględnia tymczasowe, podpisane dostarczanie.
04
Błędy przewidywalne
EasyF organizuje Error contract wokół jednego envelope poza 2xx. Jego przepływ w prostym języku porównuje identyfikator zgłoszenia do wsparcia. Przewidywalna obsługa po stronie klienta pozostaje końcowym sprawdzeniem.
{
"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. |
05
Kontrakt operacyjny
EasyF ustala praktyczne granice użytkowania z każdym zatwierdzonym produktem, aby zachować przewidywalny, prowadzony przepływ pracy.
- 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,503i 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.
Aby wyjaśnić dostęp Schema, EasyF oddziela aktywację przed eksploracją od przypisanego uwierzytelniania. Przebieg w prostym języku nadaje udokumentowanym kształtom żądań własne miejsce.
Aktywacja poprzez wsparcie
Powiedz EasyF, co budujesz, jak często będzie wywoływać API i którzy dostawcy są ważni. Weryfikacja decyduje o dozwolonych operacjach, a następnie jednorazowo ujawnia poświadczenie, zapisując wyłącznie jego bezpieczny skrót.
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.