API — Lokacje

Lokacja to punkt na mapie świata zawierający zestaw zadań do wykonania.

Wszystkie endpointy wymagają Authorization: Bearer <token>.

GET /app/locations/:id

Szczegóły lokacji wraz z listą zadań (paginacja kursorowa).

Query params:

Param	Typ	Domyślnie	Opis
cursor	string	–	Kursor paginacji zadań
limit	int	20	Liczba zadań (1–100)

Response 200:

{
  "data": {
    "id": "loc_a_vowels",
    "world_id": "world_letters",
    "name": "Wyspa Samogłosek",
    "description": "A, E, I, O, U — poznaj samogłoski!",
    "long_description": "Na Wyspie Samogłosek czekają na Ciebie zabawne zadania...",
    "icon_url": "https://cdn.lumos-islands.pl/locations/vowels.png",
    "banner_url": "https://cdn.lumos-islands.pl/locations/vowels_banner.png",
    "status": "in_progress",
    "tasks_count": 5,
    "completed_tasks": 3,
    "reward_xp": 50,
    "tasks": {
      "data": [
        {
          "id": "task_vowel_a",
          "title": "Litera A",
          "type": "quiz",
          "difficulty": "easy",
          "xp_reward": 10,
          "status": "completed",
          "order": 1
        },
        {
          "id": "task_vowel_e",
          "title": "Litera E",
          "type": "quiz",
          "difficulty": "easy",
          "xp_reward": 10,
          "status": "completed",
          "order": 2
        },
        {
          "id": "task_vowel_i",
          "title": "Litera I",
          "type": "matching",
          "difficulty": "easy",
          "xp_reward": 10,
          "status": "completed",
          "order": 3
        },
        {
          "id": "task_vowel_o",
          "title": "Litera O",
          "type": "creative",
          "difficulty": "medium",
          "xp_reward": 15,
          "status": "available",
          "order": 4
        },
        {
          "id": "task_vowel_u",
          "title": "Litera U",
          "type": "quiz",
          "difficulty": "medium",
          "xp_reward": 15,
          "status": "locked",
          "order": 5
        }
      ],
      "next_cursor": null,
      "has_more": false
    }
  }
}

Statusy zadań w lokacji

Status	Opis
locked	Wymaga ukończenia poprzedniego zadania
available	Odblokowane, gotowe do rozpoczęcia
in_progress	Rozpoczęte, ale nieukończone
completed	Ukończone

Typy zadań

Typ	Opis
quiz	Pytania jednokrotnego/wielokrotnego wyboru
matching	Łączenie elementów w pary
ordering	Układanie w kolejności
creative	Praca twórcza (rysunek, nagranie)
fill_blank	Uzupełnianie luk

Typy lokacji (type)

Pole type lokacji określa jej charakter na mapie świata:

Typ	Opis
camp	Obóz — punkt startowy, zadania wprowadzające
library	Biblioteka — quizy, czytanie, słuchanie
factory	Fabryka — mini-gry, zadania praktyczne
office	Biuro — testy, egzaminy, zadania formalne
field	Pole — zadania w plenerze, przyroda
cinema	Kino — filmy edukacyjne, video
music_studio	Studio muzyczne — zadania audio, nagrywanie
observatory	Obserwatorium — nauka, eksperymenty, odkrywanie