Skip to main content
POST
Wyświetl swoje zapisane wyniki transkrypcji. 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: transcription: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. Stronicowany obiekt zawierający podsumowania historii transkrypcji należącej do użytkownika wykonującego wywołanie 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