@timmedia/capacitor-strava-auth

Use the Strava authentication API in your capacitor app. Works on iOS, Android and Web. On native platforms, the Strava app is opened if installed. If it is not installed, the web authorization page is opened instead. This plugin does not make use of a custom callback URL scheme. Instead, the page specified with redirectUri is opened in all cases after authorization is granted. Ensure that this URL is a deep link and handle the parameters accordingly (state, code and scope are passed).

For iOS, add strava in Info.plist under LSApplicationQueriesSchemes (array) to allow your app to open Strava.

More information is found in the Strava Authentication Developer guide. Do note that after successful authorization you still need to exchange the authorization code for an access token.

Install

npm install @timmedia/capacitor-strava-auth
npx cap sync

API

• authorize(...)
• Interfaces
• Enums

authorize(...)

authorize(options: StravaAuthOptions) => Promise<void>

Authorize using the Strava API to receive an authorization code.

| Param | Type | | ------------- | --------------------------------------------------------------- | | options | StravaAuthOptions |

Interfaces

StravaAuthOptions

| Prop | Type | Description | | -------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | clientId | string | Your App ID, found in the Strava settings. | | redirectUri | string | URL to redirect to after authorization. | | responseType | 'code' | Must be code, accorind to Strava docs. | | approvalPrompt | 'force' | 'auto' | Force prompt again even if already authorized earlier. | | scope | StravaAuthScope | See Strava Docs: {@link https://developers.strava.com/docs/authentication/#details-about-requesting-access}. | | state | string | Returned as a parameter when redirected to redirectUri. |

Enums

StravaAuthScope

| Members | Value | | ----------------------- | -------------------------------- | | READ | 'read' | | READ_ALL | 'read_all' | | PROFILE_READ_ALL | 'profile:read_all' | | PROFILE_WRITE | 'profile:write' | | ACTIVITY_READ | 'activity:read' | | ACTIVITY_READ_ALL | 'activity:read_all' | | ACTIVITY_WRITE | 'activity:write' |