Get started

This is e-book translation API of Booken.pro service.
Use this API to translate EPUB, FB2, TEXT e-books to one of 107 supported languages.
For example: English, French, German, Spanish, Italian, Russian etc.
Up to 100% guaranteed to save e-book structure.

To use this API, you need to deposit your personal account balance.
Please contact us at @BookenProGroup to deposit your account balance.

API endpoint

To access to API you should use GET or POST request to this endpoint: https://booken.pro/api

To call any API method you should use method parameter, for example: https://booken.pro/api/?method=server_health

Almost all API methods return JSON structure with response code 200 on success or 400 on error.

On success example: {"data":"OK"}

On error example: {"error":"Method not allowed"}

Public methods

• server_health
• supported_doc_formats
• supported_input_languages
• supported_output_languages
• max_file_upload_in_bytes
• create_new_api_key
• check_api_key
• get_currency_rate

Private methods

To call any private method you should use your personal API key. Create an API key you can with create_new_api_key method.

• get_account_balance
• translate_book
• check_translation_status
• download_translated_document

server_health

Recommended to use this method to determine an API availability.

On success response

supported_doc_formats

Returns the supported document formats that can be translated.

On success response

supported_input_languages

Returns the supported languages of the input document that can be translated.

On success response

supported_output_languages

Returns the supported languages of the output document that can be translated.

On success response

max_file_upload_in_bytes

Returns the maximum size of the uploaded file, in bytes, that can be translated.

On success response

create_new_api_key

Creates new API key (or updates old). API key will be send to your email.

Input parameters

On success response

check_api_key

Allows to debug a server connection with your API key.

Input parameters

On success response

get_currency_rate

Return actual currency rates used in products price.

On success response

get_account_balance PRIVATE

Show your account balance. Should be used before uploading a book for translation.

Input parameters

On success response

translate_book PRIVATE

Allows to upload an ebook for translation. To upload a document you should use multipart/form-data enctype and POST request.

Input parameters

On success response

Example of HTML-form for upload ebook for translation

<form id="upload-book-form" method="post" enctype="multipart/form-data" action="https://booken.pro/api/">
	<input type="file" name="book_file_name" required="">
	<button type="submit">Translate book</button>
	<input type="hidden" name="method" value="translate_book">
	<input type="hidden" name="email" value="youremail@example.com">
	<input type="hidden" name="md5_of_api_key" value="4c501e8937759f54d3cbd8d0f655453a">
	<input type="hidden" name="translate_to_language" value="ru">
</form>

JAVA example:

HttpPost httpPost = new HttpPost("https://booken.pro/api/");
    HttpEntity entity = MultipartEntityBuilder.create()
        .addTextBody("method", "translate_book")
        .addTextBody("email", accountEmail)
        .addTextBody("md5_of_api_key", md5ApiKey)
        .addTextBody("translate_to_language", translateToLanguage)
        .addBinaryBody("book_file_name", streamToTranslate, ContentType.APPLICATION_OCTET_STREAM, uploadedFileName)
        .build();

    try (CloseableHttpClient httpClient = HttpClientBuilder.create().build();
         CloseableHttpResponse response = httpClient.execute(httpPost)) {
        //handle response
    }

check_translation_status PRIVATE

Allows to determine the status of the document translation. If status is READY then can download translated ebook with download_translated_document

Input parameters

On success response

download_translated_document PRIVATE

Allows to download the translated ebook.

Input parameters

On success response

Return translated files by HTTPS protocol.
General HTML headers:
Content-Description: File Transfer
Content-Type: application/octet-stream