Movie Planner Miniapp API

The miniapp API from Movie Planner — 11 operation(s) for miniapp.

GitHub OpenAPI

Operations 11

POST /api/miniapp/auth Обмен Telegram initData на Bearer site_session #
GET /api/miniapp/dashboard Данные главной (план, непросмотренные, сериалы) #
GET /api/miniapp/profile Профиль пользователя + подписка #
GET /api/miniapp/search Поиск фильмов/сериалов #
GET /api/miniapp/film/{kp_id} Полная карточка фильма по kp_id (для Mini App/RN) #
POST /api/miniapp/random Случайный непросмотренный фильм из базы пользователя #
POST /api/miniapp/shazam Текстовый Shazam — найти фильм по описанию #
POST /api/miniapp/plans/home Создать план домашнего просмотра #
POST /api/miniapp/plans/cinema Создать план похода в кино #
DELETE /api/miniapp/plans/{plan_id} Удалить план #
POST /api/miniapp/series/{film_id}/pin Закрепить/открепить сериал #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/movie-planner-ru:movie-planner-ru-miniapp-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

movie-planner-ru-miniapp-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Movie Planner Unified Miniapp API
  version: 1.2.2
  description: 'Единый API для Mini App, сайта movie-planner.ru, Chrome-расширения и

    нативных мобильных приложений (React Native).


    Билеты (`POST /v1/plans/{id}/tickets`) поддерживаются только для планов с `plan_type: cinema`.

    Для кино в `POST /v1/plans` передавайте реальное название и/или адрес кинотеатра; **не передавайте заглушки**

    вроде одного слова «Кинотеатр» без адреса — геокодер интерпретирует это как запрос и может выбрать случайную точку в городе.

    Если адрес пользователя ещё неизвестен, **опустите** `cinema_name` и `cinema_address`.

    При осмысленной строке и отсутствии координат сервер при `YANDEX_GEOCODER_API_KEY` нормализует адрес и подставит `cinema_lat` / `cinema_lon`.

    События в Google Calendar и .ics получают человекочитаемое описание (ссылка на Кинопоиск, кинотеатр, Яндекс.Карты).


    MCP Streamable HTTP: `/mcp` — те же Bearer-токены, что для `/v1` (инструменты для Cursor / Claude Desktop).


    Три группы авторизации:

    • `/api/miniapp/*` — Telegram Mini App (initData) ИЛИ Bearer JWT (RN).

    • `/api/site/*` — Bearer token из site_sessions.

    • `/v1/*` — версия API для агентов; Bearer = JWT, site session или OAuth token.

    Для OAuth: если при authorize указан непустой `scope`, на /v1 проверяются права

    (profile.read, movies.read/write, plans.read/write, calendar.read). Пустой scope у OAuth = полный доступ.

    • `/oauth/*` — OAuth2 code + PKCE: authorize (нужен уже залогиненный Bearer) и token.

    • `/api/extension/*` — chat_id query param (legacy).

    • `/api/auth/*` — регистрация / refresh / me, выдаёт JWT пары.

    • `/api/push/register` — FCM-токен устройств RN.

    • `/api/maps/*` — общие maps-подсказки (без авторизации).


    Стабильные поля в ответах всех плановых/фильмовых эндпоинтов совместимы,

    что даёт возможность генерировать единый клиент (openapi-typescript).'
servers:
- url: https://web-production-3921c.up.railway.app
  description: Production
security:
- BearerAuth: []
- SiteSession: []
tags:
- name: miniapp
paths:
  /api/miniapp/auth:
    post:
      tags:
      - miniapp
      summary: Обмен Telegram initData на Bearer site_session
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MiniAppAuthRequest'
      responses:
        '200':
          description: Успех.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MiniAppAuthSuccess'
        '400':
          description: Нет initData.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Невалидный initData.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Ошибка сервера.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      operationId: postApiMiniappAuth
      x-operation-id-source: derived
  /api/miniapp/dashboard:
    get:
      tags:
      - miniapp
      summary: Данные главной (план, непросмотренные, сериалы)
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardData'
      operationId: getApiMiniappDashboard
      x-operation-id-source: derived
  /api/miniapp/profile:
    get:
      tags:
      - miniapp
      summary: Профиль пользователя + подписка
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileData'
      operationId: getApiMiniappProfile
      x-operation-id-source: derived
  /api/miniapp/search:
    get:
      tags:
      - miniapp
      summary: Поиск фильмов/сериалов
      parameters:
      - in: query
        name: q
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/SearchItem'
      operationId: getApiMiniappSearch
      x-operation-id-source: derived
  /api/miniapp/film/{kp_id}:
    get:
      tags:
      - miniapp
      summary: Полная карточка фильма по kp_id (для Mini App/RN)
      parameters:
      - in: path
        name: kp_id
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Film'
      operationId: getApiMiniappFilmByKpId
      x-operation-id-source: derived
  /api/miniapp/random:
    post:
      tags:
      - miniapp
      summary: Случайный непросмотренный фильм из базы пользователя
      responses:
        '200':
          description: ok
      operationId: postApiMiniappRandom
      x-operation-id-source: derived
  /api/miniapp/shazam:
    post:
      tags:
      - miniapp
      summary: Текстовый Shazam — найти фильм по описанию
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
      responses:
        '200':
          description: ok
      operationId: postApiMiniappShazam
      x-operation-id-source: derived
  /api/miniapp/plans/home:
    post:
      tags:
      - miniapp
      summary: Создать план домашнего просмотра
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - kp_id
              - plan_datetime
              properties:
                kp_id:
                  type: integer
                plan_datetime:
                  type: string
                  format: date-time
                online_link:
                  type: string
      responses:
        '200':
          description: ok
      operationId: postApiMiniappPlansHome
      x-operation-id-source: derived
  /api/miniapp/plans/cinema:
    post:
      tags:
      - miniapp
      summary: Создать план похода в кино
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - kp_id
              - plan_datetime
              properties:
                kp_id:
                  type: integer
                plan_datetime:
                  type: string
                  format: date-time
                cinema_name:
                  type: string
                cinema_address:
                  type: string
      responses:
        '200':
          description: ok
      operationId: postApiMiniappPlansCinema
      x-operation-id-source: derived
  /api/miniapp/plans/{plan_id}:
    delete:
      tags:
      - miniapp
      summary: Удалить план
      parameters:
      - in: path
        name: plan_id
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: ok
      operationId: deleteApiMiniappPlansByPlanId
      x-operation-id-source: derived
  /api/miniapp/series/{film_id}/pin:
    post:
      tags:
      - miniapp
      summary: Закрепить/открепить сериал
      parameters:
      - in: path
        name: film_id
        required: true
        schema:
          type: integer
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                pinned:
                  type: boolean
      responses:
        '200':
          description: ok
      operationId: postApiMiniappSeriesByFilmIdPin
      x-operation-id-source: derived
components:
  schemas:
    MiniAppAuthRequest:
      type: object
      description: Telegram Mini App — строка initData из Telegram.WebApp.initData.
      properties:
        initData:
          type: string
        init_data:
          type: string
          description: Alias для initData.
    MiniAppAuthSuccess:
      type: object
      required:
      - success
      - token
      - user
      - chat_id
      - has_data
      - movies_count
      properties:
        success:
          type: boolean
          example: true
        token:
          type: string
          description: Bearer site_session для последующих /api/miniapp/* и /api/site/*.
        user:
          $ref: '#/components/schemas/MiniAppTelegramUser'
        chat_id:
          type: integer
        has_data:
          type: boolean
        movies_count:
          type: integer
    SearchItem:
      type: object
      properties:
        kp_id:
          type: integer
        title:
          type: string
        year:
          type:
          - integer
          - 'null'
        poster:
          type:
          - string
          - 'null'
        rating:
          type:
          - number
          - 'null'
        is_series:
          type: boolean
    Plan:
      type: object
      required:
      - id
      - plan_type
      - plan_datetime
      - title
      properties:
        id:
          type: integer
        plan_id:
          type: integer
          description: Идентификатор плана, равен id; используется для удаления, не film_id и не kp_id.
        year:
          type:
          - integer
          - 'null'
        created_by_user_id:
          type:
          - integer
          - 'null'
          description: Автор плана; поле добавлено к существующему ответу.
        plan_type:
          type: string
          enum:
          - home
          - cinema
        plan_datetime:
          type: string
          format: date-time
        title:
          type: string
        film_id:
          type:
          - integer
          - 'null'
        kp_id:
          type:
          - integer
          - 'null'
        cinema_name:
          type:
          - string
          - 'null'
        cinema_address:
          type:
          - string
          - 'null'
        online_link:
          type:
          - string
          - 'null'
        is_series:
          type: boolean
    ProfileData:
      type: object
      properties:
        user:
          type: object
          properties:
            user_id:
              type: integer
            chat_id:
              type: integer
            username:
              type:
              - string
              - 'null'
            first_name:
              type:
              - string
              - 'null'
        stats:
          type: object
          properties:
            films:
              type: integer
            series:
              type: integer
            plans:
              type: integer
            unwatched:
              type: integer
        subscription:
          type: object
          properties:
            plan:
              type: string
            until:
              type:
              - string
              - 'null'
              format: date-time
    Film:
      type: object
      properties:
        film_id:
          type:
          - integer
          - 'null'
        kp_id:
          type: integer
        title:
          type: string
        year:
          type:
          - integer
          - 'null'
        poster:
          type:
          - string
          - 'null'
        description:
          type:
          - string
          - 'null'
        rating:
          type:
          - number
          - 'null'
        genres:
          oneOf:
          - type: array
            items:
              type: string
          - type: string
        is_series:
          type: boolean
        in_library:
          type: boolean
        watched:
          type: boolean
        my_rating:
          type:
          - integer
          - 'null'
          minimum: 1
          maximum: 10
        online_link:
          type:
          - string
          - 'null'
        link:
          type:
          - string
          - 'null'
    MiniAppTelegramUser:
      type: object
      properties:
        id:
          type: integer
        first_name:
          type:
          - string
          - 'null'
        last_name:
          type:
          - string
          - 'null'
        username:
          type:
          - string
          - 'null'
        photo_url:
          type:
          - string
          - 'null'
        language_code:
          type:
          - string
          - 'null'
        is_premium:
          type: boolean
    DashboardData:
      type: object
      properties:
        name:
          type: string
        counts:
          type: object
          properties:
            unwatched:
              type: integer
            watched:
              type: integer
            series:
              type: integer
            plans:
              type: integer
            total:
              type: integer
        plans:
          type: array
          items:
            $ref: '#/components/schemas/Plan'
        unwatched:
          type: array
          items:
            $ref: '#/components/schemas/Film'
        series:
          type: array
          items:
            $ref: '#/components/schemas/Film'
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    SiteSession:
      type: apiKey
      in: header
      name: Authorization
      description: Bearer <site_session_token>