Setting up OAuth 2.0 - Introduction

This article is part of this article serie: API Best Practices - Introduction

This article serie will guide you through the process of connecting to Twinfield's API using OAuth 2.0.

Good to know: Are you new to OAuth 2.0? Please read this article for more information: What is OAuth 2.0?

Good to know: We've added a Postman collection in the attachment of this introduction article.
 

How does it work?

Connecting to Twinfield's API is as simple as:

1. Registering your application at Twinfield's developers portal.
2. Asking the end user for permission.
3. Obtaining an access token to be able to process and/or request data.

Getting started

There are two authorization flows you can use. These are called Authorization code and Implicit. Please read this article to understand the difference between the two: Difference between authorization code flow and implicit flow

Did you choose for the authorization code flow? Then you have to follow these steps:

• Register a client ID for your application
• Ask the end user for permission
• Request a refresh token
• Request a new access token
• Send a request

Did you choose for the implicit flow? Then you have to follow these steps:

• Register a client ID for your application
• Ask the end user for permission
• Send a request

Frequently asked questions

• Does the end user need a Wolters Kluwer Account for OAuth 2.0?
• Can I find code snippets for C#, PHP and other languages?

Known errors

• What does this error mean: Invalid client
• What does this error mean: Invalid_grant
• What does this error mean: Invalid scope
• What does this error mean: The client application is not known or is not authorized
• What does this error mean: unsupported_grant_type
• What does this error mean: "U hebt geen toegang tot subadministratie"
• What does this error mean: Access Denied. Company is required
• What does this error mean: An error occurred on the server. Always include the following error reference when you report this error: [error not saved]

Continue reading

You can find our complete API documentation here: https://accounting.twinfield.com/webservices/documentation/#/
 

Need some help?

If you still need help after reading these articles, please contact Twinfield's support team by logging in to the Twinfield Developers Portal at https://developers.twinfield.com . From there you can create a support ticket.