Tylko podgląd — wymagana aktywacja

Zbuduj pobieranie z EasyT

To odniesienie EasyT jest raczej przewodnikiem implementacyjnym niż aktywnym anonimowym punktem końcowym. Dostęp produkcyjny rozpoczyna się dopiero po zatwierdzeniu klienta przez dział wsparcia i przypisaniu limitów.

EasytWorkspaceJSON przez HTTPSZadania asynchronicznePoświadczenia zakresowe

Szybki start

Host API zaczyna się od poświadczeń z aktywacją wsparcia na EasyT. Ta prowadzona kontrola następnie przedstawia przypisany punkt końcowy dzierżawy. Ostatecznym faktem jest ścieżka wywołania tylko po stronie serwera.

URL dzierżawcyhttps://easyt.io

UwierzytelnianieX-API-Key: pending_activation_…

Profil klientaEasytWorkspace

Wersja APIv1

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

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

W EasyT, bezpieczne przechowywanie tajnych danych po stronie serwera jest najważniejsze przy wyjaśnianiu bezpieczeństwa Credential. Następuje po nim prowadząca kontrola dotycząca braku osadzania pakietu po stronie klienta, a całość kończy się brakiem publicznych logów lub repozytoriów.

Rozwiązywanie linku

Rozpoczęcie operacji polega na wykryciu źródła na EasyT. Ta prowadzona kontrola następnie prezentuje formaty z jednego przesłanego URL-a. Ostatecznym faktem jest brak wymyślonych wyników.

POST/v1/resolveZakres: rozwiązać

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

W EasyT zwrócona wartość bez zmian pojawia się najpierw przy wyjaśnianiu identyfikatora formatu. Ta prowadzona kontrola następuje potem wraz z dostępnością dla każdego łącza i kończy się bez żadnej zgadywanej etykiety jakości.

Tworzenie i śledzenie zadania pobierania

Asynchroniczne przygotowanie to punkt startowy dla tworzenia zadania na EasyT. Następnie prowadzona kontrola przedstawia krótkie żądanie HTTP i wyjaśnia ograniczone wykonanie pracownika.

POST/v1/jobsZakres: oferty pracy

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

1202 ZaakceptowanoSave workspace_job.

2Status ankietyGET /v1/jobs/{workspace_job} 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://easyt.io/v1/jobs/WORKSPACE_JOB \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN"

Dla sondowania zadań, EasyT zaczyna się od jednosekundowego początkowego oczekiwania. Jego prowadzona kontrola łączy to z ograniczonym powrotem i kończy się tymczasową podpisaną dostawą.

Błędy przewidywalne

EasyT ułatwia skanowanie kontraktu błędu. Strona zaczyna się od jednej koperty nie-2xx, przechodzi do identyfikatora zgłoszenia wsparcia i jasno określa 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

EasyT wybiera przydział operacyjny podczas przeglądu, równoważąc potrzeby aplikacji ze zdrowiem dostawcy.

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.

Dostęp do schematu rozpoczyna się od aktywacji przed eksploracją na EasyT. Ta prowadzona kontrola następnie przedstawia przypisaną autentykację. Ostatecznym faktem są udokumentowane kształty żądań.

DOSTOSOWANY DO OPERATORA DOSTĘP

Aktywacja poprzez wsparcie

Uwzględnij cel klienta, oczekiwane miesięczne obciążenie pracą i żądane sieci w nocie aktywacyjnej. EasyT może wtedy poprawnie wybrać zakresy resolve i job przed utworzeniem one-view secret.

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.