Tylko podgląd — wymagana aktywacja

Zbuduj pobieranie z Insto

Insto przedstawia plan integracji mediów wizualnych do oceny. Analiza na żywo i żądania zadań pozostają niedostępne, dopóki pomoc techniczna nie udzieli autoryzacji w zakresie danego najemcy.

InstoMediaJSON przez HTTPSZadania asynchronicznePoświadczenia zakresowe

Szybki start

Dla hosta API, Insto zaczyna się od poświadczeń aktywowanych przez wsparcie. Jego przegląd pobierania łączy to z przypisanym punktem końcowym dzierżawy i kończy się ścieżką wywołania tylko po stronie serwera.

URL dzierżawcyhttps://insto.app

UwierzytelnianieX-API-Key: pending_activation_…

Profil klientaInstoMedia

Wersja APIv1

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

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

Insto przedstawia trzy praktyczne wskazówki dotyczące bezpieczeństwa Credential. Pierwsza dotyczy przechowywania sekretów po stronie serwera. Następnie omówiona jest weryfikacja pobierania bez osadzania w pakiecie klienta. Ostatnia wskazówka to brak publicznych logów lub repozytoriów.

Rozwiązywanie linku

W przypadku operacji Resolve Insto rozpoczyna od wykrywania źródła. Jego przegląd pobierania łączy to z formatami z jednego przesłanego adresu URL i kończy się bez wymyślonych wyników.

POST/v1/resolveZakres: rozwiązać

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

Insto przedstawia trzy praktyczne punkty dotyczące identyfikatora formatu. Najpierw pojawia się zwrócona wartość bez zmian. Następnie przegląd pobierania obejmuje dostępność dla każdego łącza. Ostatni punkt to brak zgadywanej etykiety jakości.

Tworzenie i śledzenie zadania pobierania

Insto organizuje tworzenie zadań wokół asynchronicznego przygotowania. Jego przegląd pobierania porównuje krótkie żądanie HTTP. Ograniczone wykonanie przez pracowników pozostaje końcowym sprawdzeniem.

POST/v1/jobsZakres: oferty pracy

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

1202 ZaakceptowanoSave prepare_id.

2Status ankietyGET /v1/jobs/{prepare_id} 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://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

W Insto najpierw pojawia się początkowe oczekiwanie trwające jedną sekundę, gdy wyjaśnia się odpytywanie zadania. Następnie recenzja pobierania przechodzi do ograniczonego wycofywania i kończy się na tymczasowym podpisanym dostarczaniu.

Błędy przewidywalne

Aby wyjaśnić Error contract, Insto oddziela jedną kopertę inną niż 2xx od identyfikatora żądania pomocy technicznej. Recenzja pobierania daje przewidywalnej obsłudze po stronie klienta własne miejsce.

{
  "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

Insto dostosowuje limity połączeń do zastosowania w mediach wizualnych i sieci, z którymi skontaktuje się zatwierdzony klient.

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.

W przypadku dostępu do Schema Insto zaczyna się od aktywacji przed eksploracją. Jego przegląd pobierania łączy to z przypisaną uwierzytelnieniem i kończy się udokumentowanymi kształtami żądań.

DOSTOSOWANY DO OPERATORA DOSTĘP

Aktywacja poprzez wsparcie

Określ produkt multimedialny, przewidywane miesięczne użycie oraz typy wpisów, którymi planujesz się zajmować. Insto przyznaje wyłącznie niezbędne zakresy analizy lub przygotowania i nigdy nie przechowuje czytelnego tokenu.

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.