Creating Cross-Authorization Links via API

A cross-authorization link allows your users to open documents in the Smartcat Editor without entering their login credentials. This is how it works.

To create a cross-authorization link, you should assign a user to the document first. Unassigned users are not able to open the Editor via this link. To assign the user to the dedicated document, use POST document/assign method (use documentId (int1_int2 format), stageNumber (=1 for translation), and the id for the Smartcat user id, and disregard other optional parameters).

Important: the user should already have a Smartcat account. Otherwise you can create an account on the fly using Smartcat User API.

Once the user is successfully assigned to the document, you can create a cross-authorization link. To do that, use the GET document/getAuthUrl method (use id for the Smartcat user id and the documentId (int1_int2 format)). Smartcat returns a string value which contains a cross-auth URL to the document.

Important: the cross-auth link is valid within 30 seconds.

Was this article helpful?