https://quickt.ioZbuduj pobieranie z QuickT
QuickT dokumentuje, jak klient mobilny komunikowałby się z usługą. Nie może przesłać pracy produkcyjnej, dopóki wsparcie nie zatwierdzi projektu i nie włączy dostępu zakresowego.
Szybki start
Dla hosta API, QuickT sprawdza poświadczenia aktywowane wsparciem przed przypisanym punktem końcowym najemcy. Ten widok gotowy do urządzenia również wyraźnie pokazuje ścieżkę wywołania tylko serwera.
X-API-Key: pending_activation_…QuicktRoutev1# Available only after support activation
export QUICKT_ROUTE_TOKEN="issued-after-review"
curl -X POST https://quickt.io/v1/resolve \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'QuickT organizuje bezpieczeństwo poświadczeń wokół tajnego magazynu po stronie serwera. Jego widok gotowy do urządzenia porównuje brak osadzania pakietów klienta.
Rozwiązywanie linku
Dla operacji Resolve, QuickT sprawdza wykrywanie źródła przed formatami z jednego przesłanego URL. Ten widok gotowy do urządzenia również jasno pokazuje brak wymyślonych wyjść.
/v1/resolveZakres: rozwiązać| Field | Typ | Wymagane | Opis |
|---|---|---|---|
route_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
}QuickT organizuje identyfikator formatu wokół zwróconej wartości bez zmian. Jego widok gotowy do urządzenia porównuje dostępność na link. Brak zgadywanej etykiety jakości pozostaje ostateczną kontrolą.
Tworzenie i śledzenie zadania pobierania
Aby wyjaśnić tworzenie zadania, QuickT oddziela asynchroniczne przygotowanie od krótkiego żądania HTTP. Widok gotowy na urządzenie nadaje ograniczonemu wykonaniu pracownika własne miejsce.
/v1/jobsZakres: oferty pracy| Field | Typ | Wymagane | Opis |
|---|---|---|---|
route_source | Adres HTTPS | Tak | To samo znormalizowane źródło złożone do rozwiązania. |
route_format | 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://quickt.io/v1/jobs \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID","route_format":"18"}'route_job.GET /v1/jobs/{route_job} 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://quickt.io/v1/jobs/ROUTE_JOB \
-H "X-API-Key: $QUICKT_ROUTE_TOKEN"Jednosekundowe początkowe oczekiwanie jest punktem startowym dla sondowania zadań na QuickT. Widok gotowy do urządzenia następnie prezentuje ograniczone opóźnienie i wyjaśnia tymczasową podpisaną dostawę.
Błędy przewidywalne
Dla kontraktu błędu QuickT zaczyna od jednej koperty nie-2xx. Jego widok gotowy do urządzenia łączy to z identyfikatorem żądania wsparcia i kończy się przewidywalnym obsługiwaniem 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
QuickT wybiera limity mobilne-klient podczas zatwierdzania, więc sieci twórców i API pozostają elastyczne.
- 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.
Dla dostępu do schematu QuickT sprawdza aktywację przed eksploracją, a następnie przypisane uwierzytelnianie. Ten widok gotowy do urządzenia również wyraźnie przedstawia udokumentowane kształty żądań.
Aktywacja poprzez wsparcie
Opisz doświadczenie mobilne, oczekiwany ruch i sieci twórców, których potrzebuje. QuickT wykorzystuje te informacje do przydzielania analiz i uprawnień do kolejki przed ujawnieniem sekretu.
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.