Skip to main content
POST
Pobierz stronicowaną historię zużycia minut tłumaczenia i synchronizacji ruchu ust, naliczeń i zwrotów, z opcjonalnymi filtrami daty, języka, stanu i projektu.

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: usage: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

string
Wartość tekstowa.Dozwolone wartości: “translation”, “project”. Wartość domyślna: “translation”.
string
Wartość tekstowa.Minimalna długość: 1. Maksymalna długość: 200. Wzorzec: ^[^/]+$.
string
Wartość tekstowa.Minimalna długość: 1. Maksymalna długość: 200.
string
Wartość tekstowa.Minimalna długość: 2. Maksymalna długość: 64.
string
Wartość tekstowa.Dozwolone wartości: “all”, “none”, “standard”, “pro”, “pro_2”.
array
Lista wartości. Strukturę elementów opisuje pełny schemat danych wejściowych.Maksymalna liczba elementów: 4.
string
Wartość tekstowa.Dozwolone wartości: “all”, “charged”, “refunded”, “refund_pending”.
string
Wartość tekstowa.Format: “date”. Wzorzec: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$.
string
Wartość tekstowa.Format: “date”. Wzorzec: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$.
integer
Liczba całkowita.Minimum: 1. Maksimum: 100000. Wartość domyślna: 1.
integer
Liczba całkowita.Minimum: 1. Maksimum: 100. Wartość domyślna: 25.
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. Zwraca stronicowane wiersze wykorzystania tłumaczeń lub projektów, znormalizowane filtry oraz sumy minut ze wszystkich pasujących wierszy.

Pola wyniku

Uwagi do operacji

  • view ma domyślnie wartość translation, page — 1, a pageSize — 25; pageSize nie może przekraczać 100.
  • Filtry dat używają YYYY-MM-DD i porównują datę rozpoczęcia tłumaczenia w strefie Europe/Paris. fromDate nie może być późniejsze niż toDate.
  • project przeszukuje nazwy i identyfikatory projektów bez rozróżniania wielkości liter. translatedVersionId dopasowuje identyfikatory wersji według podciągu w widoku tłumaczeń i jest ignorowany w widoku projektów.
  • Sumy obejmują wszystkie pasujące wiersze tłumaczeń przed podziałem na strony. Widok projektów agreguje te wiersze według projektu.
  • Publiczne wiersze pomijają adresy e-mail użytkowników inicjujących operację i surowe komunikaty błędów przetwarzania.

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