journey

The journey overview

Everything the journey tab opens on, in one call: days together, the streak, the rolling deneme averages with their trend per exam type, the newest denemeler, a 30-day study summary, and the strongest and weakest topics.

Averages are over the last three denemeler of an exam type. TYT and AYT are never combined. The trend compares that window against the same window shifted one deneme back, so a single good paper moves it and a single old one leaving does too.

The streak counts days with meaningful activity: a chat message, a completed study block, a logged deneme, or a saved check-in. current reads 0 once a day has been missed.

GET

api

journey

The journey overview

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

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

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

{
  "daysTogether": 0,
  "streak": {
    "current": 0,
    "longest": 0
  },
  "exams": [
    {
      "examType": "TYT",
      "avgNet": 123,
      "trend": "up",
      "count": 0,
      "subjects": [
        {
          "subject": "<string>",
          "label": "<string>",
          "short": "<string>",
          "avgNet": 123,
          "trend": "up",
          "count": 0
        }
      ]
    }
  ],
  "recentDenemeler": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "examType": "TYT",
      "field": "EA",
      "name": "<string>",
      "publisher": "<string>",
      "takenDate": "<string>",
      "durationMin": 0,
      "totalNet": 123,
      "source": "manual",
      "createdBy": "student",
      "notes": "<string>",
      "subjects": [
        {
          "subject": "<string>",
          "label": "<string>",
          "short": "<string>",
          "dogru": 0,
          "yanlis": 0,
          "bos": 0,
          "net": 123
        }
      ],
      "topics": [
        {
          "subject": "<string>",
          "topic": "<string>",
          "dogru": 0,
          "yanlis": 0,
          "bos": 0
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "study": {
    "days": 0,
    "totalMin": 0,
    "activeDays": 0,
    "dailyAvgMin": 0
  },
  "strongTopics": [
    {
      "subject": "<string>",
      "label": "<string>",
      "short": "<string>",
      "examType": "TYT",
      "topic": "<string>",
      "accuracy": 123,
      "total": 0
    }
  ],
  "weakTopics": [
    {
      "subject": "<string>",
      "label": "<string>",
      "short": "<string>",
      "examType": "TYT",
      "topic": "<string>",
      "accuracy": 123,
      "total": 0
    }
  ]
}

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

Authorizations

Authorization

string

header

required

Supabase access token: Authorization: Bearer <token>

Response

The overview

daysTogether

integer

required

Days since sign-up, first day inclusive.

Required range: -9007199254740991 <= x <= 9007199254740991

streak

object

required

Show child attributes

exams

object[]

required

One entry per exam type the student has denemeler for.

Show child attributes

recentDenemeler

object[]

required

Show child attributes

study

object

required

Show child attributes

strongTopics

object[]

required

Show child attributes

weakTopics

object[]

required

Show child attributes

The journey overview

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

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

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

{
  "daysTogether": 0,
  "streak": {
    "current": 0,
    "longest": 0
  },
  "exams": [
    {
      "examType": "TYT",
      "avgNet": 123,
      "trend": "up",
      "count": 0,
      "subjects": [
        {
          "subject": "<string>",
          "label": "<string>",
          "short": "<string>",
          "avgNet": 123,
          "trend": "up",
          "count": 0
        }
      ]
    }
  ],
  "recentDenemeler": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "examType": "TYT",
      "field": "EA",
      "name": "<string>",
      "publisher": "<string>",
      "takenDate": "<string>",
      "durationMin": 0,
      "totalNet": 123,
      "source": "manual",
      "createdBy": "student",
      "notes": "<string>",
      "subjects": [
        {
          "subject": "<string>",
          "label": "<string>",
          "short": "<string>",
          "dogru": 0,
          "yanlis": 0,
          "bos": 0,
          "net": 123
        }
      ],
      "topics": [
        {
          "subject": "<string>",
          "topic": "<string>",
          "dogru": 0,
          "yanlis": 0,
          "bos": 0
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "study": {
    "days": 0,
    "totalMin": 0,
    "activeDays": 0,
    "dailyAvgMin": 0
  },
  "strongTopics": [
    {
      "subject": "<string>",
      "label": "<string>",
      "short": "<string>",
      "examType": "TYT",
      "topic": "<string>",
      "accuracy": 123,
      "total": 0
    }
  ],
  "weakTopics": [
    {
      "subject": "<string>",
      "label": "<string>",
      "short": "<string>",
      "examType": "TYT",
      "topic": "<string>",
      "accuracy": 123,
      "total": 0
    }
  ]
}

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

Overview

Endpoints

The journey overview

Authorizations

Response