This API endpoint requires authentication to be used.
RequestAuthentication endpoint returns a URL to give to a user to authenticate with your application using Donut Team.
As with the rest of the API, arguments are passed as part of the URI separated by forward slashes.
Your application's API key.
Handling the response
A successful response will return the following values:
|Code||This code is a temporary key that will be used to query if a user has authenticated with your app. You should re-query this code using CheckAuthenticateToken every 20 seconds while waiting for authentication. This code will expire after 15 minutes if it is not authenticated within that time.|
|Link||The link you should open in the user's browser to allow authentication. This link will expire after 15 minutes if it is not authenticated within that time.|
An error response will return the following values:
|ErrorCode||An error code used for internal development purposes. Endpoint separated by two colons and then an incriminating number. This should be used when you want to handle the error yourself.|
|ErrorText||Error text to explain what is happening.|
|RequestAuthentication::1||No API Public Key provided.|
|RequestAuthentication::2||Provided public key was not found.We were unable to find your application's API in our database. You may have a mistake in the key you gave us.|
|RequestAuthentication::3||No API Public Key provided.|
|RequestAuthentication::4||API does not have permission for request authentication.Your application does not have the permission to request authentication.|
|RequestAuthentication::5||API understood your request but was unable to fulfill it.An error occurred on our end that was irrecoverable.|