journey

One subject, in depth

The per-subject screen: the rolling average and trend of the subject net, the net of each deneme in the window, all-time completed study minutes on the subject, and the topic table — success rate and consistency per topic, with the strong and weak topics already picked out.

The path parameter is the canonical subject key, e.g. tyt_turkce, ayt_matematik, lgs_fen. Consistency needs three denemeler of topic data and is null until then.

GET

api

journey

subjects

{subject}

One subject, in depth

curl --request GET \
  --url https://client-api.lala.ist/api/journey/subjects/{subject} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://client-api.lala.ist/api/journey/subjects/{subject}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "subject": "<string>",
  "label": "<string>",
  "short": "<string>",
  "examType": "TYT",
  "count": 0,
  "avgNet": 123,
  "trend": "up",
  "totalStudyMin": 0,
  "series": [
    {
      "denemeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "takenDate": "<string>",
      "net": 123,
      "name": "<string>"
    }
  ],
  "topics": [
    {
      "topic": "<string>",
      "total": 0,
      "correct": 0,
      "accuracy": 123,
      "consistency": "high",
      "denemeCount": 0
    }
  ],
  "strongTopics": [
    {
      "topic": "<string>",
      "total": 0,
      "correct": 0,
      "accuracy": 123,
      "consistency": "high",
      "denemeCount": 0
    }
  ],
  "weakTopics": [
    {
      "topic": "<string>",
      "total": 0,
      "correct": 0,
      "accuracy": 123,
      "consistency": "high",
      "denemeCount": 0
    }
  ]
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Supabase access token: Authorization: Bearer <token>

Path Parameters

subject

string

required

Query Parameters

window

integer

default:10

How many of the newest denemeler feed the topic aggregates.

Required range: 1 <= x <= 30

Response

The subject detail

subject

string

required

Canonical subject key — exam-prefixed, e.g. tyt_matematik, ayt_tarih1, lgs_fen.

label

string

required

short

string

required

examType

enum<string>

required

One scored paper. TYT and AYT nets are never summed.

Available options:

TYT,

AYT,

LGS

count

integer

required

Denemeler in the window containing the subject.

Required range: -9007199254740991 <= x <= 9007199254740991

avgNet

number

required

trend

enum<string>

required

Direction of the rolling average: the newest window of 3 against the same window shifted one deneme back.

Available options:

up,

down,

flat

totalStudyMin

integer

required

All-time completed planner minutes on this subject.

Required range: -9007199254740991 <= x <= 9007199254740991

series

object[]

required

Newest first.

Show child attributes

topics

object[]

required

Show child attributes

strongTopics

object[]

required

Show child attributes

weakTopics

object[]

required

Show child attributes

One subject, in depth

curl --request GET \
  --url https://client-api.lala.ist/api/journey/subjects/{subject} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://client-api.lala.ist/api/journey/subjects/{subject}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "subject": "<string>",
  "label": "<string>",
  "short": "<string>",
  "examType": "TYT",
  "count": 0,
  "avgNet": 123,
  "trend": "up",
  "totalStudyMin": 0,
  "series": [
    {
      "denemeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "takenDate": "<string>",
      "net": 123,
      "name": "<string>"
    }
  ],
  "topics": [
    {
      "topic": "<string>",
      "total": 0,
      "correct": 0,
      "accuracy": 123,
      "consistency": "high",
      "denemeCount": 0
    }
  ],
  "strongTopics": [
    {
      "topic": "<string>",
      "total": 0,
      "correct": 0,
      "accuracy": 123,
      "consistency": "high",
      "denemeCount": 0
    }
  ],
  "weakTopics": [
    {
      "topic": "<string>",
      "total": 0,
      "correct": 0,
      "accuracy": 123,
      "consistency": "high",
      "denemeCount": 0
    }
  ]
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "error": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ]
}

Overview

Endpoints

One subject, in depth

Authorizations

Path Parameters

Query Parameters

Response