PowerPlatformConnectors/certified-connectors/DeepL
Tim Cadenbach 85011ed2f5
Deepl api updates (#3489)
* Commit connector

* fix description length

* fix brand color

* Requested changes

* Update apiDefinition.swagger.json

* update description for DeepL connector

* update deepl connector

* Fix description, remove power automate wording

* store changes

* Update API Definition

* remove unused files

---------

Co-authored-by: Tim Cadenbach <tim.cadenbach@deepl.com>
2024-05-27 19:39:44 +05:30
..
apiDefinition.swagger.json Deepl api updates (#3489) 2024-05-27 19:39:44 +05:30
apiProperties.json Commit DeepL connector (#2109) 2022-11-07 11:36:30 -08:00
readme.md Commit DeepL connector (#2109) 2022-11-07 11:36:30 -08:00

readme.md

Publisher: DeepL

DeepL API

Our goal is to overcome language barriers and bring cultures closer together. In order to achieve that goal, we are using our expertise in artificial intelligence and neural networks to create technologies that make communication faster, better, and easier.

The DeepL API provides programmatic access to DeepLs machine translation technology, making it possible to bring high quality translation capabilities directly to your websites and applications.

Prerequisites

  • A DeepL API subscription is required, you can sign up for the Free or Pro plan on our Website: DeepL API.

Obtaining Credentials

  • After signing up you can retrieve your API key directly from your account overview Account Overview

Supported Operations

The connector can use all operations possible using DeepL API. You can find more details about all operations and explanations about the various parameters here: DeepL API Docs

Translate

The main translate function allows translating any text. Currently only UTF-8 encoded plain text is supported.

Manage Glossaries

The glossary functions allow you to create, inspect, and delete glossaries. Glossaries created with the glossary function can be used in translate requests by specifying the glossary_id parameter

Translate Documents

The document translation API allows you to translate whole documents.

Translating a document usually involves three steps:

  • upload the document to be translated,
  • periodically check the status of the document translation,
  • once the status call reports done, download the translated document.

Please note that with every submitted document of type .pptx, .docx, or .pdf, you are billed a minimum of 50,000 characters with the DeepL API plan, no matter how many characters are included in the document.

Known issues and limitations

Some endpoints currently only accept URL-Encoded form data, this will be changed to JSON soon.

Deployment Instructions

After deployment, you need to setup the connector with your API Key and Subscription. This will make sure the connector is using the correct URL.