Microsoft Translator API Cognitive Services - What is the correct endpoint?

Question

The Microsoft Azure portal for TextTranslator provides the following endpoint:

https://api.cognitive.microsoft.com/sts/v1.0

Yet this endpoint returns a 200 for issueToken and 404 for Translate. The samples refer to an endpoint of:

https://api.microsofttranslator.com/v2/http.svc/

The docs being out of date given the translator ending in the datamarket was my initial assumption. However, the doc endpoint returns for the Translate method.

http://docs.microsofttranslator.com/text-translate.html#!/default/get_Translate

Which endpoint is it that we should use?

If supposed to use the api.microsofttranslator.com then what is the api.cognitive.microsoft.com in azure for?

Domitian

Answer 1

For the translator API, you need to first get an auth token (first link), and with this token you can call the Translate api (second link).

You can learn more about the auth step here.

Reliquiae

thanks. I see. Weird. Not too sure I trust getting API tokens from one service and then using them with another in general. Seems like a scenario ripe for creating security bugs if used as a general pattern. – Domitian

api.cognitive.microsoft.com/sts/v1.0/issueToken is returning 404. The interactive tool at docs.microsofttranslator.com/oauth-token.html is returning "error": "no response from server". Anyone know if Microsoft is performing maintenance or what is going on? – Haith

Finally got it to work with a POST and Ocp-Apim-Subscription-Key in the header. – Haith

Answer 2

You can use Microsoft Translator API in 2 ways (see the docs):

• in 1 step: invoke (GET) https://api.microsofttranslator.com/V2/Http.svc/Translate?text=Neoliberismo&from=it&to=en, passing Ocp-Apim-Subscription-Key: your_subscription_key as request header
• in 2 steps, with OAuth:
  • invoke (POST) https://api.cognitive.microsoft.com/sts/v1.0/issueToken, passing Subscription-Key=your_subscription_key as query parameter or better passing Ocp-Apim-Subscription-Key: your_subscription_key as request header
  • you'll get a token that expires after 10 minutes
  • invoke (GET) https://api.microsofttranslator.com/V2/Http.svc/Translate?text=Neoliberismo&from=it&to=en, passing Authorization: Bearer the_token as request header

Electrochemistry