SimklApi

Constructors

Link copied to clipboard
constructor()

Types

Link copied to clipboard
object Companion
Link copied to clipboard
class SimklEpisodeConstructor(simklId: Int?, type: String?, totalEpisodeCount: Int?, hasEnded: Boolean?)

Useful to get episodes on demand to prevent unnecessary requests.

Link copied to clipboard
class SimklSyncStatus(var status: SyncWatchType, var score: Score?, val oldScore: Int?, var watchedEpisodes: Int?, val episodeConstructor: SimklApi.SimklEpisodeConstructor, var isFavorite: Boolean? = null, var maxEpisodes: Int? = null, val oldEpisodes: Int, val oldStatus: String?) : SyncAPI.AbstractSyncStatus

Properties

Link copied to clipboard
open override val createAccountUrl: String

Link to a website for creating a new account

Link copied to clipboard
open val hasInApp: Boolean = false

Has in app login support, aka login with a dialog

Link copied to clipboard
open override val hasOAuth2: Boolean = true

Has OAuth2 login support, including login, loginRequest and refreshToken

Link copied to clipboard
open override val hasPin: Boolean = true

Has on device pin support, aka login with a QR code

Link copied to clipboard
open override val icon: ERROR CLASS: Unresolved name: simkl_logo

Drawable icon of the service

Link copied to clipboard
open override val idPrefix: String
Link copied to clipboard

The requirements to login in app

Link copied to clipboard
val key: String
Link copied to clipboard
open override var mainUrl: String
Link copied to clipboard
open override var name: String
Link copied to clipboard
open override val redirectUrlIdentifier: String

The sensitive redirect URL from OAuth should contain "/redirectUrlIdentifier" to trigger the login

Link copied to clipboard
open override var requireLibraryRefresh: Boolean

Set this to true if the user updates something on the list like watch status or score

Link copied to clipboard
open val requiresLogin: Boolean = true

If this service requires an account to use

Link copied to clipboard

Currently unused, but will be used to correctly render the UI. This should specify what sync watch types can be used with this service.

Link copied to clipboard
open override val syncIdName: SyncIdName

Allows certain providers to open pages from library links.

Functions

Link copied to clipboard
Link copied to clipboard
open suspend fun invalidateToken(token: AuthToken): Nothing

An optional security measure to make sure that even if an attacker gets ahold of the token, it will be invalid.

Link copied to clipboard

Is this url a valid redirect url for this service?

Link copied to clipboard
open suspend override fun library(auth: AuthData?): SyncAPI.LibraryMetadata?

Get the current library/bookmarks of this service

Link copied to clipboard
open suspend override fun load(auth: AuthData?, id: String): SyncAPI.SyncResult?

Get metadata about an item

Link copied to clipboard
open suspend fun login(form: AuthLoginResponse): AuthToken?

In app login

open suspend override fun login(payload: AuthPinData): AuthToken?

Pin login, this will be called periodically while logging in to check if the pin has been verified by the user

open suspend override fun login(redirectUrl: String, payload: String?): AuthToken?

OAuth2 login from a valid redirectUrl, and payload given in loginRequest

Link copied to clipboard
Link copied to clipboard
open override fun loginRequest(): AuthLoginPage?

OAuth2 login request, asking the service to provide a url to open in the browser

Link copied to clipboard
open suspend override fun pinRequest(): AuthPinData?

Pin login request, asking the service to provide an verificationUrl to display with a QR code

Link copied to clipboard
open suspend fun refreshToken(token: AuthToken): AuthToken?

OAuth2 token refresh, this ensures that all token passed to other functions will be valid

Link copied to clipboard
open suspend override fun search(auth: AuthData?, query: String): List<SyncAPI.SyncSearchResult>?

Search this service for any results for a given query

Link copied to clipboard
open suspend override fun status(auth: AuthData?, id: String): SyncAPI.AbstractSyncStatus?

Get the current status of an item

Link copied to clipboard
Link copied to clipboard
open suspend override fun updateStatus(auth: AuthData?, id: String, newStatus: SyncAPI.AbstractSyncStatus): Boolean

Modify the current status of an item

Link copied to clipboard
open override fun urlToId(url: String): String?

Helper function, may be used in the future

Link copied to clipboard
open suspend override fun user(token: AuthToken?): AuthUser?

Get the visible user account