Skip to main content
POST
Wyświetl swoje zapisane wyniki tłumaczenia napisów. Użyj nextCursor jako beforeHistoryId, aby pobrać starsze wyniki.

Uwierzytelnianie i uprawnienia

string
wymagane
Wyślij klucz API VoiceCheap w tym nagłówku. Obsługiwany jest również nagłówek Authorization: Bearer z tym samym kluczem API. Tokeny dostępu OAuth są akceptowane tylko przez MCP, a nie przez ten endpoint REST.
Wymagane uprawnienia: subtitles:read. Wymagana jest aktywna płatna subskrypcja. Uprawnienia nie zmieniają ról w zespole, własności zasobów, kredytów na multimedia ani limitów planu.

Parametry

integer
Liczba całkowita.Minimum: 1. Maksimum: 100. Wartość domyślna: 30.
string
Wartość tekstowa.Minimalna długość: 1. Maksymalna długość: 160. Wzorzec: ^[A-Za-z0-9_-]+$.
Poniższy JSON Schema zachowuje dokładne nazwy pól, typy zagnieżdżone, wartości domyślne, ograniczenia i akceptowane wartości udostępniane przez mechanizm wykrywania. Dodatkowe reguły zależności między polami znajdują się w uwagach do operacji.

Przykłady żądań

Zastąp przykładowe identyfikatory zasobów i klucze multimediów wartościami zwróconymi dla Twojego konta. Przy ponawianiu tej samej operacji zmieniającej dane zachowaj identyfikator żądania.

Odpowiedź

Pierwsze pomyślne wykonanie zwraca HTTP 200 z wynikiem operacji w data. Ponowienie może zamiast tego zwrócić zapisany stan żądania. Przykład przedstawia jedną obsługiwaną odpowiedź, bez wszystkich opcjonalnych pól. Obiekt z podziałem na strony zawierający podsumowania historii tłumaczenia napisów należącej do użytkownika wykonującego żądanie oraz nextCursor.

Pola wyniku

Uwagi do operacji

  • Wymaga płatnej subskrypcji i uprawnienia do akcji. Osobisty plan narzędzi użytkownika wykonującego żądanie jest ponownie sprawdzany podczas wykonywania; zapisane narzędzia i referencje przesłanych plików należą do tego użytkownika, również gdy dane uwierzytelniające są powiązane z zespołem.
  • Pomyślna akcja zużywa jedno wspólne miesięczne wywołanie API/MCP. Beginner pozwala na 500, Starter na 5,000, a Creator na 25,000 wywołań miesięcznie; Pro, Scale i Enterprise nie mają miesięcznego limitu. Nadal obowiązują limity na minutę: odpowiednio 30, 60, 120, 180, 300 i 600. Limity generowania narzędzi są odrębne.
  • limit ma domyślną wartość 30 i akceptuje liczby całkowite od 1 do 100. Wyniki są uporządkowane od najnowszych do najstarszych. Przekaż nextCursor jako beforeHistoryId dla następnej strony; null oznacza brak starszej strony.
  • Zwracane elementy to podsumowania osobistej zapisanej historii narzędzi internetowych. Różnią się od trwałej kolekcji wyników integracji result_list; narzędzia zapisują historię w miarę możliwości, bez gwarancji powodzenia.
  • Ten odczyt nie generuje multimediów ani nie zużywa dziennego limitu narzędzia; zużywa jedno udane wywołanie z miesięcznego limitu integracji.

Wykorzystanie

Każde pomyślne wywołanie zużywa jedno wywołanie z miesięcznego limitu API/MCP. Obowiązują również kredyty na multimedia oraz limity generowania danej operacji.

Błędy