Files
lpt-android/app/src/main/java/com/catshark/lpt/data/LptApi.kt
T

73 lines
2.5 KiB
Kotlin

package com.catshark.lpt.data
import kotlinx.serialization.json.JsonElement
import retrofit2.http.Body
import retrofit2.http.GET
import retrofit2.http.POST
import retrofit2.http.PUT
import retrofit2.http.Path
import retrofit2.http.Query
/**
* lpt-be 学习会话相关接口(不含复习模块)。
* 认证走请求头 `satoken`,由 ApiClient 的拦截器注入。
*/
interface LptApi {
@POST("login")
suspend fun login(@Body body: LoginRequest): ApiEnvelope<JsonElement>
@POST("logout")
suspend fun logout(): ApiEnvelope<JsonElement>
@GET("tasks")
suspend fun tasks(): ApiEnvelope<TaskPage>
@GET("study-sessions/active")
suspend fun activeSession(
@Query("excludeTaskNum") excludeTaskNum: String? = null,
): ApiEnvelope<ActiveSession>
@GET("tasks/{taskNum}/study-sessions/start-or-continue")
suspend fun startOrContinue(@Path("taskNum") taskNum: String): ApiEnvelope<SessionDetail>
@GET("study-sessions/{sessionNum}")
suspend fun sessionDetail(@Path("sessionNum") sessionNum: String): ApiEnvelope<SessionDetail>
@GET("study-sessions/{sessionNum}/expectation")
suspend fun getExpectation(@Path("sessionNum") sessionNum: String): ApiEnvelope<Expectation>
@PUT("study-sessions/{sessionNum}/expectation")
suspend fun putExpectation(
@Path("sessionNum") sessionNum: String,
@Body body: ExpectationRequest,
): ApiEnvelope<Expectation>
@POST("study-sessions/{sessionNum}/study-sessions/continue")
suspend fun continueSession(@Path("sessionNum") sessionNum: String): ApiEnvelope<JsonElement>
@POST("study-sessions/{sessionNum}/study-sessions/pause")
suspend fun pauseSession(
@Path("sessionNum") sessionNum: String,
@Query("endTime") endTime: String? = null,
): ApiEnvelope<JsonElement>
@POST("study-sessions/{sessionNum}/study-sessions/ended")
suspend fun endSession(
@Path("sessionNum") sessionNum: String,
@Body body: EndSessionRequest,
): ApiEnvelope<JsonElement>
@POST("study-sessions/{sessionNum}/study-sessions/abort")
suspend fun abortSession(
@Path("sessionNum") sessionNum: String,
@Body body: AbortRequest,
): ApiEnvelope<JsonElement>
@POST("report-fragments")
suspend fun createFragment(@Body body: CreateFragmentRequest): ApiEnvelope<JsonElement>
@GET("report-fragments/session/{sessionNum}")
suspend fun fragmentsBySession(@Path("sessionNum") sessionNum: String): ApiEnvelope<List<FragmentItem>>
}