0.0.1 • Published 2 years ago

@timmedia/capacitor-strava-auth v0.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

@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(...)

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

Authorize using the Strava API to receive an authorization code.

ParamType
optionsStravaAuthOptions

Interfaces

StravaAuthOptions

PropTypeDescription
clientIdstringYour App ID, found in the Strava settings.
redirectUristringURL 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.
scopeStravaAuthScopeSee Strava Docs: {@link https://developers.strava.com/docs/authentication/#details-about-requesting-access}.
statestringReturned as a parameter when redirected to redirectUri.

Enums

StravaAuthScope

MembersValue
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'