Wprowadzenie

Zapewnia interfejsy RESTful API do tłumaczenia dokumentów, obsługując automatyczne zarządzanie zadaniami tłumaczeniowymi, spójność terminologii opartą na glosariuszach oraz zapytania dotyczące obsługiwanych formatów, języków i modeli, ułatwiając budowanie płynnych procesów tłumaczeniowych i zarządzanie kontami użytkowników.

Pierwsze kroki

Aby rozpocząć, musisz złożyć wniosek o zostanie deweloperem.Aplikuj jako programista

Po zatwierdzeniu można utworzyć wiele kluczy API i uwzględnić odpowiedni klucz API w każdym żądaniu API zgodnie z wymaganiami.

Uzyskaj swój klucz API

Szybkie podłączenie

Base URL

https://dltranslator.com/api

Metoda uwierzytelnienia

Authorization: [yourSecretKey]

Zapytanie JSON

Z wyjątkiem interfejsu przesyłania plików, interfejsy domyślnie używają żądań POST JSON, Content-Type to application/json.

Przesyłanie pliku

Tworzenie zadania tłumaczenia dokumentu wykorzystuje multipart/form-data, w polu file przekazywany jest plik do przetłumaczenia.

Uniwersalna odpowiedź błędu

W przypadku niepowodzenia żądania interfejs zwróci JSON, a pole error będzie zawierać stały komunikat o błędzie w języku angielskim. Zaleca się priorytetowe obsługiwanie błędów według kodu statusu HTTP, a pole error używać do wyświetlania lub zapisywania w logach.

{
  "error": "Invalid API key."
}

Reguły kodów statusu błędów

Wszystkie odpowiedzi błędów API v1 mają taką samą strukturę, proszę obsługiwać według poniższych reguł kodu statusu HTTP.

400 Bad Request: Missing required parameters, invalid parameter formats or enum values, missing file upload, upload save failure, or task processing failure.
401 Unauthorized: Missing API key or invalid API key.
402 Payment Required: Insufficient credits balance for preview, full translation, or text translation.
404 Not Found: The task or glossary does not exist, has been deleted, does not belong to the current API account, or was not created through the API.
409 Conflict: The current task status does not allow the requested operation.
500 Internal Server Error: Unexpected server exception. The response error is fixed as "Internal server error.".

Zalecany proces integracji

1. Tworzenie zadania

Prześlij plik i utwórz zadanie tłumaczenia, zwraca taskId.

2. Sprawdzanie postępu

Odpytuj status zadania do momentu uzyskania statusu Completed, Terminated lub Cancelled.

3. Pobieranie wyniku

Pobierz plik tłumaczenia lub odczytaj JSON oryginału i tłumaczenia.

4. Zarządzanie zadaniami

Płać według użycia za pełne tłumaczenie, ponowne uruchomienie zadania, rewizję tekstu lub usunięcie zadania.

Zasoby

Społeczność deweloperów

W przypadku pytań możesz uzyskać pomoc w społeczności deweloperów.