Client creation

To start working with GoSpeech API you have to create the API Client. In order to do this, open API Client page in GoSpeech and configure the subsequent Client settings:

• App name - name of your system you want to integrate GoSpeech into.
• Grant type - application grant types (or flows) are methods that allow you to give applications Access tokens and grant another entities limited access to your resources without exposing credentials. Learn more about the grant types we proivde and possible values on Authentication. To determine which grant type value best suits your needs select one of Integration Scenarios first. Each type is tbest suited for the respective integration scenario:
  • Scenario 1. System as user - Resource owner password.
  • Scenario 2. Integration with user management and access to GoSpeech interface - Client credentials and resource owner password.
  • Scenario 3. Integration with self-sufficient users - Authorization code.
• Authorized origins - this refers to the list of URLs from which your application is allowed to make requests to the OAuth 2.0 server. This prevents unauthorized cross-origin requests.
• Authorized redirect URLs - these are pre-registered URLs to which the OAuth 2.0 server can send responses. After a user successfully authorizes an application, the server redirects the user back to the application using one of these URLs. It's crucial for the security of the application as it ensures that the authorization codes and tokens are sent to the correct destination.
• Authorized post logout redirect URLs - these are the URLs to which the user can be redirected after a successful logout. This ensures that the user is taken to a safe location after ending their session.

When you´ve configured all settings press the "Generate new key" button. You should get the following parameters, that should be preserved:

• Client ID - this is a public identifier for your app. It's unique to each client and is used by the authorization server to identify different applications.
• Client secret - this is a secret key that is only known to the application and the authorization server. It's used to authenticate the application when it requests access to a user's account and must be kept confidential.

📘

Note

Keep in mind that after leaving or refreshing the page the Client secret is not shown again. If you don't retain it on your side you have to generate it again.

Also on this page you can find the following settings under the section "GoSpeech URLs" which will be used in your system:

• Application URL - the main URL of GoSpeech application. It should be used as a base part of API requests URLs.
• Authorization URL - the base URL for authentication and authorization.

🚧

Note

If you don't see API Client tab in your GoSpeech Account Settings it means your account was not changed to a Developer account. Contact us byEnterprise/API request form on the Billing plan page.