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.
openapi: 3.2.0
info:
title: Movie Planner Unified Tags 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: Tags
paths:
/v1/tags:
get:
tags:
- Tags
summary: Список пользовательских тегов
security:
- BearerAuth: []
- SiteSession: []
responses:
'200':
description: ok
operationId: getV1Tags
x-operation-id-source: derived
post:
tags:
- Tags
summary: Создать тег
security:
- BearerAuth: []
- SiteSession: []
responses:
'201':
description: created
operationId: postV1Tags
x-operation-id-source: derived
/v1/tags/assign-bulk:
post:
tags:
- Tags
summary: Повесить тег на много фильмов (kp_ids / film_ids)
security:
- BearerAuth: []
- SiteSession: []
responses:
'200':
description: ok
operationId: postV1TagsAssignBulk
x-operation-id-source: derived
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
SiteSession:
type: apiKey
in: header
name: Authorization
description: Bearer <site_session_token>