Skip to content

Connector v2: Migration Guide

Overview

The client app connection has been upgraded to a more secure method. The legacy GET endpoint is deprecated and replaced with POST HMAC-SHA256 authentication.


What Changed?

Old (Deprecated) New (Recommended)
HTTP Method GET POST
URL /client/connect /client/connect/v2
Authentication client_secret in URL HMAC signature

Migration Steps

Step 1: Update the URL

Old:

https://admin.dotykacka.cz/client/connect

New:

https://admin.dotykacka.cz/client/connect/v2


Step 2: Change from GET to POST

Old (GET):

GET /client/connect?client_id=X&client_secret=SECRET&scope=*&redirect_uri=Y

New (POST):

POST /v2/client/connect
Content-Type: application/x-www-form-urlencoded
client_id=X&timestamp=1704123456&signature=abc123...&scope=*&redirect_uri=Y


Step 3: Implement HMAC Authentication

For complete implementation details including:

  • HMAC signature calculation
  • Timestamp format and generation
  • Request parameters
  • Code examples
  • Troubleshooting

See the Authorization documentation