Uzyskaj szczegółowe raporty dotyczące użycia API dzięki parametrowi „Pokaż rozliczane znaki” w DeepL
Najważniejsze wnioski
- Użytkownicy API DeepL mogą zgłaszać raporty dotyczące liczby znaków rozliczonych dla każdego pomyślnego żądania API.
- Parametr show_billed_characters zapewnia użytkownikom natychmiastowy dostęp do danych dotyczących użycia API bezpośrednio w odpowiedzi API.
- Te dane o użyciu na żądanie można wykorzystać w niestandardowych raportach i procesach śledzenia kosztów bezpośrednio z API.
- Jest to szczególnie przydatne w przypadku treści strukturalnych, takich jak HTML lub XML, gdzie znalezienie znaków podlegających tłumaczeniu może być trudniejsze.
- Ta funkcja rozszerza możliwości raportowania API DeepL poza punkt końcowy /użycie i pomaga monitorować aktywność tłumaczeniową z większą precyzją.
- Nowy parametr show_billed_characters jest już dostępny dla wszystkich klientów API DeepL bez dodatkowej konfiguracji.
API DeepL zawsze traktowało raportowanie i analizę jako priorytet dla programistów i firm takich jak Twoja. Dotyczy to zarówno punktu końcowego /usage bezpośrednio w samym API, jak i funkcji raportowania dla wiele kluczy API.
Nasz zespół wprowadził to wygodne uzupełnienie do naszej rosnącej listy narzędzi raportowych: show_billed_characters jest teraz dostępne dla wszystkich klientów API.
To rozszerza rosnącą funkcjonalność raportowania API DeepL. Umożliwia to teraz szczegółowy wgląd w liczbę znaków rozliczonych w danych odpowiedzi dla każdego żądania API.
Czym jest parametr show_billed_characters?
Wcześniej użytkownicy API, którzy chcieli uzyskać dokładne dane o użyciu bezpośrednio z API DeepL, mieli tylko jedną opcję – wywołanie punktu końcowego /usage. To świetny sposób na pobranie najbardziej aktualnych danych o użyciu znaków w obecnym okresie rozliczeniowym. Nie zapewnia to jednak dokładnego podziału znaków tłumaczonych w każdym żądaniu.
Opcjonalny parametr rozwiązuje ten problem, zwracając liczbę przetłumaczonych i rozliczonych znaków wraz z odpowiedzią na każde pomyślne żądanie API.
Odkryj elastyczne raportowanie na poziomie klucza dla użytkowników API DeepL.
Jak działa parametr show_billed_characters?
Klienci API wysyłający żądania bezpośrednio do API, np. za pomocą polecenia cURL, mogą dodać nowy parametr show_billed_characters do swoich żądań. W ten sposób w danych odpowiedzi pojawi się liczba rozliczonych znaków.
Odpowiedzi API, w których występuje koszt znaków, będą wtedy zwracać nową wartość całkowitą w formacie „billed_characters:50” w każdej odpowiedzi.
Możesz śledzić tę wartość po stronie odbiorcy API, aby wykorzystać ją w procesach raportowania i śledzić koszt każdego indywidualnego żądania API.
Jest to szczególnie ważne w przypadku żądań zawierających treści strukturalne, takie jak HTML lub XML, gdzie identyfikacja znaków podlegających tłumaczeniu może być trudna.
W przyszłości zespół DeepL planuje domyślnie uwzględniać „billed_characters” w odpowiedzi API DeepL. Wtedy trzeba będzie skonfigurować show_billed_characters na „false”, żeby nie uwzględniać „billed_characters” w odpowiedzi API.
Dowiedz się, jak DeepL wzmacnia bezpieczeństwo dzięki wielu kluczom API.
Jak wygląda odpowiedź API z opcją show_billed_characters
Obecnie po wysłaniu żądania do API otrzymujesz odpowiedź podobną do tej:
Twoja odpowiedź będzie wyglądać tak, jeśli wyślesz żądanie z nowym parametrem show_billed_characters:
Zobacz sześć zmian w tłumaczeniach, z których globalne przedsiębiorstwa powinny skorzystać już teraz.
Dlaczego DeepL dodało raportowanie liczby znaków rozliczanych na żądanie
Wielu klientów prosiło o to narzędzie. Pozwala ono na szczegółowe raportowanie rozliczeń za znaki i bezpośrednią integrację tych danych z Twoimi własnymi narzędziami raportowymi po każdym pomyślnym żądaniu tłumaczenia przez API.
Parametr show_billed_characters działa w pełni w ramach API dla użytkowników DeepL – nie wymaga dodatkowej konfiguracji.
Dodatkowo zaktualizowaliśmy naszą dokumentację API, aby odzwierciedlić tę zmianę, ułatwiając programistom, takim jak Ty, integrację tej funkcji z Twoimi procesami pracy i zacznij czerpać korzyści z większej dokładności tłumaczeń.
Aby uzyskać więcej informacji, przeczytaj Opisy treści żądania oraz Informacje o aktualizacji.