Recco is a health recommendation tool, that can be integrated in your own web- or smartphone application. Get in contact by following this link: https://www.significo.com/recco

Setup

Within the Recco Backoffice

• Log in to the Recco Backoffice and follow the steps to configure your application
• Create an App-Token within the Recco Backoffice, copy it and keep it safe

In your web-application

In order to give your users the opportunity to sign up to the web-version of Recco, you need to link it in your web-app. For authentication, Recco expects a Session-Token as query param in the URL:

https://recco-web.significo.app?session-token=[YOUR_SESSION_TOKEN]

Create Session Token

Step 1: Get Transient Token

Create a one-time PAT for the app, with a 1-minute lifespan and scoped to the supplied User-Id.

Call POST https://recco-api.significo.dev/api/v1/app_users/transient_tokens

Add an Authorization header to this request and add your App-Token there (the token you received in the Recco Backoffice):
Authorization: Bearer [YOUR_APP_TOKEN]

Add also Client-User-Id to the request header. That ID will Recco use to identify the user, that wants to use Recco.
Client-User-Id: [ID]

As response, you will get a Transient-Token. This token will expire after 1 minute.

Step 2: Get Session Token

Call https://recco-api.significo.dev/api/v1/app_users/tokens

Add an Authorization header to this request and add your Transient-Token there (the token you received in the request before):
Authorization: Bearer [YOUR_TRANSIENT_TOKEN]

As response, you will get a Session-Token. The Session-Token can be added as query-param to the Recco URL in order to sign in to the web version of Recco.

URL Query Params

• session-token: For authentication of the user.
• lang (optional): Determine the application language. Currently supported are en and de. If omitted, the browser language will be used.