{ "openapi": "3.0.0", "info": { "title": "API LANGAME", "version": "1.0" }, "paths": { "/api/app/clubs/get": { "get": { "tags": [ "App.Clubs" ], "summary": "Получение информации о клубе", "operationId": "api.app.clubs.get", "parameters": [ { "name": "id", "in": "query", "description": "ID клуба", "example": 799449414 }, { "name": "lang", "in": "query", "description": "Язык", "example": "ru" } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RClubAggregated" } } } }, "401": { "description": "Unauthorized" } }, "security": [ { "bearerAuth": [] } ] } }, "/api/app/clubs/list": { "get": { "tags": [ "App.Clubs" ], "summary": "Получение информации о клубах", "operationId": "api.app.clubs.list", "parameters": [ { "name": "ids[]", "in": "query", "description": "ID клубов", "schema": { "type": "array", "items": { "type": "string" }, "example": [ "799449414", "799449845" ] } }, { "name": "lang", "in": "query", "description": "Язык", "example": "ru" } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RClubAggregated" } } } }, "401": { "description": "Unauthorized" } }, "security": [ { "bearerAuth": [] } ] } }, "/api/auth/login": { "post": { "tags": [ "Auth" ], "summary": "Авторизация. Получение токена", "operationId": "api.auth.login", "parameters": [ { "name": "phone", "in": "query", "description": "Телефон", "required": true }, { "name": "password", "in": "query", "description": "Пароль", "required": true } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/RLogin" } }, "type": "object" } } } }, "400": { "description": "Auth error", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean", "example": "false" }, "error": { "type": "string", "example": "Auth error description" } }, "type": "object" } } } } } } }, "/api/documents/get": { "get": { "tags": [ "Documents" ], "summary": "Получение контента документа", "operationId": "api.documents.get", "parameters": [ { "name": "label", "in": "query", "description": "Идентификатор документа", "required": true, "schema": { "type": "string", "enum": [ "POLICY", "USER_AGREEMENT", "SOFTWARE_SLA", "SOFTWARE_LICENSE", "SOFTWARE_AGREEMENT", "APPLE_ENROLLMENT", "ABOUT", "TOURNAMENT_RULES_OF_QUALIFYING_STAGE", "TOURNAMENT_STATUS_PROTECTION_REGULATIONS", "TOURNAMENT_SPORTS_REGULATIONS", "TOURNAMENT_RULES_OF_FINAL", "TOURNAMENT_TECHNICAL_ISSUES", "TOURNAMENT_CONCEPT", "TOURNAMENT_CHECK_LIST" ] } }, { "name": "lang", "in": "query", "description": "Язык", "schema": { "type": "string", "enum": [ "ru" ] } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean", "example": "true" }, "document": { "$ref": "#/components/schemas/RDocument" } }, "type": "object" } } } }, "401": { "description": "Unauthorized" } } } }, "/api/external/clubs/list": { "get": { "tags": [ "External" ], "summary": "Получение списка клубов по городу и стране", "operationId": "api.external.clubs.list", "parameters": [ { "name": "country_id", "in": "query", "description": "ID страны", "required": true, "example": 1 }, { "name": "city_id", "in": "query", "description": "ID города", "required": true, "example": 637640 }, { "name": "page", "in": "query", "description": "Номер страницы", "required": true, "example": 1 }, { "name": "limit", "in": "query", "description": "Кол-во записей на странице", "required": true, "example": 250 } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean" }, "pagination": { "$ref": "#/components/schemas/RPagination" }, "list": { "type": "array", "items": { "$ref": "#/components/schemas/RClub" } } }, "type": "object" } } } }, "403": { "description": "Unauthorized" } }, "security": [ { "externalToken": [] } ] } }, "/api/external/geo/city/search": { "get": { "tags": [ "External" ], "summary": "Поиск города", "operationId": "api.external.geo.country", "parameters": [ { "name": "search", "in": "query", "required": true, "example": "моск" } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean" }, "list": { "type": "array", "items": { "$ref": "#/components/schemas/RCityExternal" } } }, "type": "object" } } } }, "403": { "description": "Unauthorized" } }, "security": [ { "externalToken": [] } ] } }, "/api/forms/software/send": { "post": { "tags": [ "Forms" ], "summary": "Обработка формы Software", "operationId": "api.forms.software.send", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SoftwareFormRequest" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean", "example": "true" } }, "type": "object" } } } }, "401": { "description": "Unauthorized" } } } }, "/api/geo/country/{id}": { "get": { "tags": [ "GEO" ], "summary": "Getting information about country by ID", "operationId": "api.geo.country", "parameters": [ { "name": "id", "in": "path", "required": true, "example": "1" } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/RCountry" } }, "type": "object" } } } } } } }, "/api/geo/city/{id}": { "get": { "tags": [ "GEO" ], "summary": "Getting information about city by ID", "operationId": "api.geo.city", "parameters": [ { "name": "id", "in": "path", "required": true, "example": "637640" } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/RCity" } }, "type": "object" } } } } } } }, "/api/geo/ipInfo": { "get": { "tags": [ "GEO" ], "summary": "Getting information about the IP address", "operationId": "api.geo.ipInfo", "parameters": [ { "name": "ip", "in": "query", "description": "IP-address", "required": true } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/RIpData" } }, "type": "object" } } } } } } }, "/api/offers/list": { "get": { "tags": [ "Offers" ], "summary": "Получение оферов биржи", "operationId": "api.offers.list", "parameters": [ { "name": "search", "in": "query", "description": "Поиск" }, { "name": "object", "in": "query", "description": "Объект офера", "schema": { "type": "string", "enum": [ "club", "company" ] } }, { "name": "page", "in": "query", "description": "Страница", "example": 1 }, { "name": "limit", "in": "query", "description": "Записей на страницу", "example": 25 } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ROffer" } }, "total": { "type": "integer", "example": "93" }, "page": { "type": "integer", "example": "1" }, "pages": { "type": "integer", "example": "4" }, "hasMore": { "type": "boolean", "example": "true" } }, "type": "object" } } } }, "401": { "description": "Unauthorized" } } } }, "/api/personal/clubs/uploadPriceList": { "post": { "tags": [ "Personal.Clubs" ], "summary": "Обновление прайслиста клуба", "operationId": "api.personal.clubs.uploadPriceList", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "required": [ "file" ], "properties": { "clubId": { "description": "ID клуба (приоритет перед serverId)", "type": "integer", "example": "1" }, "serverId": { "description": "ID сервера клуба в формате [0-9]-[0-9]", "type": "string" }, "file": { "description": "Файл прайс-листа клуба", "type": "string", "format": "binary" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RUploadPriceList" } } } }, "401": { "description": "Unauthorized" } }, "security": [ { "bearerAuth": [] } ] } }, "/conference/createOrder": { "post": { "tags": [ "Conference" ], "summary": "Создание заказа билетов", "operationId": "front.conference.createOrder", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateOrderFormRequest" } } } }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ROrder" } } } }, "401": { "description": "Unauthorized" } } } }, "/conference/createPayment": { "post": { "tags": [ "Conference" ], "summary": "Создание платежки билетов", "operationId": "front.conference.createPayment", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePaymentFormRequest" } } } }, "responses": { "200-1": { "description": "QR", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean", "example": "true" }, "paymentAmount": { "type": "number", "format": "float", "example": "100.1" }, "paymentUrl": { "type": "string", "example": "https://qr.nspk.ru/..." }, "paymentQrData": { "type": "number", "example": "iVBORw0KG...AAizA" } }, "type": "object" } } } }, "200-2": { "description": "Cards", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean", "example": "true" }, "paymentAmount": { "type": "number", "format": "float", "example": "100.1" }, "paymentUrl": { "type": "string", "example": "https://qr.nspk.ru/..." } }, "type": "object" } } } } } } }, "/conference/checkPayment": { "post": { "tags": [ "Conference" ], "summary": "Проверка поручения", "operationId": "front.conference.checkPayment", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckPaymentFormRequest" } } } }, "responses": { "200": { "description": "Success checking", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean", "example": "true" }, "paymentStatus": { "type": "string", "enum": [ "Pending", "Authorized", "Completed" ] } }, "type": "object" } } } } } } }, "/meetup/createOrder": { "post": { "tags": [ "Meetup" ], "summary": "Создание заказа билетов", "operationId": "front.meetup.createOrder", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateMeetupOrderFormRequest" } } } }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RMeetupOrder" } } } }, "401": { "description": "Unauthorized" } } } }, "/meetup/createPayment": { "post": { "tags": [ "Meetup" ], "summary": "Создание платежки билетов", "operationId": "front.meetup.createPayment", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateMeetupPaymentFormRequest" } } } }, "responses": { "200-1": { "description": "QR", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean", "example": "true" }, "paymentUrl": { "type": "string", "example": "https://qr.nspk.ru/..." }, "paymentQrData": { "type": "number", "example": "iVBORw0KG...AAizA" } }, "type": "object" } } } }, "200-2": { "description": "Cards", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean", "example": "true" }, "paymentUrl": { "type": "string", "example": "https://qr.nspk.ru/..." } }, "type": "object" } } } } } } }, "/meetup/checkPayment": { "post": { "tags": [ "Meetup" ], "summary": "Проверка поручения", "operationId": "front.meetup.checkPayment", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckMeetupPaymentFormRequest" } } } }, "responses": { "200": { "description": "Success checking", "content": { "application/json": { "schema": { "properties": { "status": { "type": "boolean", "example": "true" }, "paymentStatus": { "type": "string", "enum": [ "Pending", "Authorized", "Completed" ] } }, "type": "object" } } } } } } } }, "components": { "schemas": { "SoftwareFormRequest": { "description": "Параметры запроса отправки формы Software", "properties": { "club": { "description": "Название вашего клуба/сети клубов", "type": "string", "example": "Клубешник" }, "extensions": { "description": "Подключаемые расширения/услуги", "type": "array", "items": { "oneOf": [ { "enum": [ "SUPPORT", "ONLINE_PAYMENT", "MOBILE_BOOKING", "TERMINAL", "ADMIN_TABLET", "E_CASES", "TV_CONTROLLER", "NETWORK_SETTING" ] } ] } }, "quantity": { "description": "Общее количество ПК и консолей", "type": "integer", "example": 2 }, "name": { "description": "Как вас зовут?", "type": "string", "example": "Серега" }, "post": { "description": "Роль в клубе", "type": "string", "enum": [ "OWNER", "MANAGER", "MARKETING_MANAGER", "ADMINISTRATOR", "SOOWNER" ] }, "city": { "description": "Город", "type": "string", "example": "Москва" }, "phone": { "description": "Телефон", "type": "string", "example": "+79998887766" }, "email": { "description": "Email", "type": "string", "example": "someemail@dot.com" } }, "type": "object" }, "RLogin": { "properties": { "id": { "type": "integer", "example": "1" }, "name": { "type": "string", "example": "Иванов Иван" }, "phone": { "type": "string", "example": "79876543210" }, "email": { "type": "string", "example": "user.email@host.com" }, "type": { "type": "string", "example": "owner" }, "accessToken": { "type": "string", "example": "c316ab...da8bfb" } }, "type": "object" }, "RClubAggregated": { "properties": { "id": { "type": "integer", "example": "799449414" } }, "type": "object" }, "REquipment": { "properties": { "isVip": { "type": "boolean", "example": "false" }, "pcQty": { "type": "integer", "example": "25" }, "name": { "type": "string", "example": "STANDART PREMIUM" }, "cpuVendorName": { "type": "string", "example": "Intel" }, "cpuModelName": { "type": "string", "example": "Core i5-13400F" }, "videoVendorName": { "type": "string", "example": "NVIDIA" }, "videoModelName": { "type": "string", "example": "GeForce RTX 4060 TI 8 Gb" }, "ramSizeName": { "type": "string", "example": "32 Gb" }, "ramTypeName": { "type": "string", "example": "DDR4" }, "hddTypeName": { "type": "string", "example": "Гибридная система" }, "keyboardVendorName": { "type": "string", "example": "ASUS" }, "mouseVendorName": { "type": "string", "example": "ASUS" }, "headphoneVendorName": { "type": "string", "example": "ASUS" }, "chairVendorName": { "type": "string", "example": "Knight" }, "monitorVendorName": { "type": "string", "example": "ASUS" }, "monitorDiagonalName": { "type": "string", "example": "27''" }, "monitorFrequencyName": { "type": "string", "example": "280" }, "internetSpeedName": { "type": "string", "example": ">1 Гбит" } }, "type": "object" }, "RRequisites": { "properties": { "exist": { "type": "boolean", "example": "true" }, "name": { "type": "string", "example": "ИП Иванов Сергей Петрович" }, "inn": { "type": "string", "example": "112233445566" }, "director": { "type": "string", "example": "Иванов Сергей Петрович" }, "termsOfReturn": { "type": "string", "example": "В случае невозможности оказания услуг..." } }, "type": "object" }, "RService": { "properties": { "enabled": { "type": "boolean", "example": "true" }, "key": { "type": "string", "example": "booking" }, "title": { "type": "string", "example": "Онлайн-бронь" }, "description": { "type": "string", "example": "В этом клубе используется LANGAME Software" }, "icon": { "type": "string", "example": "booking" } }, "type": "object" }, "RUploadPriceList": { "properties": { "clubId": { "type": "integer", "example": "1" }, "url": { "type": "string", "example": "URL нового прайс-листа" } }, "type": "object" }, "RDocument": { "properties": { "label": { "type": "string", "example": "POLICY" }, "lang": { "type": "string", "example": "ru" }, "content": { "type": "string", "example": "

HTML content

" } }, "type": "object" }, "RCityExternal": { "properties": { "id": { "type": "integer", "example": "637640" }, "country_id": { "type": "integer", "example": "1" }, "country": { "type": "string", "example": "Россия" }, "name": { "type": "string", "example": "Москва" }, "region": { "type": "string", "example": "МО" }, "lat": { "type": "string", "example": "55.75322" }, "lon": { "type": "string", "example": "37.622513" } }, "type": "object" }, "RClub": { "properties": { "id": { "type": "integer", "example": "100001" }, "name": { "type": "string", "example": "COLIZEUM Мир Митино" }, "url": { "type": "string", "example": "https://langame.ru/club/100001" }, "lat": { "type": "string", "example": "55.649774" }, "lon": { "type": "string", "example": "37.739626" }, "address": { "type": "string", "example": "Новочеркасский бульвар, 57, Москва, Россия" } }, "type": "object" }, "RCity": { "properties": { "id": { "type": "integer", "example": "637640" }, "name": { "type": "string", "example": "Москва" }, "region": { "type": "string", "example": "МО" }, "lat": { "type": "string", "example": "55.75322" }, "lon": { "type": "string", "example": "37.622513" } }, "type": "object" }, "RCountry": { "properties": { "id": { "type": "integer", "example": "1" }, "name": { "type": "string", "example": "Россия" }, "iso": { "type": "string", "example": "ru" }, "currency": { "type": "string", "example": "rub" } }, "type": "object" }, "RIpData": { "properties": { "ip": { "type": "string", "example": "145.78.96.154" }, "ipLong": { "type": "number", "example": "2437832858" }, "countryIso": { "type": "string", "example": "KR" }, "countryName": { "type": "string", "example": "South Korea" }, "regionName": { "type": "string", "example": "Gyeonggi-do" }, "cityName": { "type": "string", "example": "Hanam" } }, "type": "object" }, "RMetro": { "properties": { "id": { "type": "integer", "example": "138" }, "name": { "type": "string", "example": "Южная" }, "color": { "type": "string", "example": "ADACAC" } }, "type": "object" }, "ROffer": { "properties": { "id": { "type": "integer", "example": "799447852" }, "name": { "type": "string", "example": "Б/У кресла DXRacer Formula" }, "object": { "type": "string", "example": "company" }, "about": { "type": "string", "example": "

Short HTML

" }, "description": { "type": "string", "example": "

Full HTML

" }, "price": { "type": "number", "format": "float", "example": "1000.0" }, "image": { "type": "string", "example": "https://langame.ru/storage/offers/2022/Jun/store62a0b60f67aab.jpg" }, "created_at": { "type": "string", "example": "2021-10-12 15:35:36" }, "published_at": { "type": "string", "example": "2023-05-16 12:09:13" }, "user_name": { "type": "string", "example": "Максим" }, "user_phone": { "type": "string", "example": "+7 999 888-77-66" }, "user_email": { "type": "string", "example": "maksim@email.com" }, "club_name": { "type": "string", "example": "F5 Центр киберспорта Сокол" }, "club_url": { "type": "string", "example": "https://langame.ru/club/651016491" } }, "type": "object" }, "RPagination": { "properties": { "page": { "type": "integer", "example": "1" }, "limit": { "type": "integer", "example": "15" }, "total": { "type": "integer", "example": "35" }, "pages": { "type": "integer", "example": "3" }, "hasMore": { "type": "boolean", "example": true } }, "type": "object" }, "CheckPaymentFormRequest": { "description": "Параметры запроса проверки статуса оплаты", "properties": { "orderUuid": { "type": "string", "example": "8849d46e-1219-4004-9f62-23575b48cab7" } }, "type": "object" }, "CreateOrderFormRequest": { "description": "Параметры запроса создания заказа билетов", "properties": { "order": { "type": "array", "items": { "properties": { "phone": { "type": "string", "example": "+79998887755" }, "name": { "type": "string", "example": "Петя Иванов" }, "city_id": { "type": "integer", "example": "621554" }, "club_name": { "type": "string", "example": "Clubchik" }, "email": { "type": "string", "example": "some@email.com" }, "telegram": { "type": "string", "example": "@telegram" } }, "type": "object" } } }, "type": "object" }, "CreatePaymentFormRequest": { "description": "Параметры запроса оплаты билетов", "properties": { "orderUuid": { "type": "string", "example": "8849d46e-1219-4004-9f62-23575b48cab7" }, "method": { "type": "string", "enum": [ "SBP", "CARD", "PAYZE" ] } }, "type": "object" }, "CheckMeetupPaymentFormRequest": { "description": "Параметры запроса проверки статуса оплаты", "properties": { "orderUuid": { "type": "string", "example": "8849d46e-1219-4004-9f62-23575b48cab7" } }, "type": "object" }, "CreateMeetupOrderFormRequest": { "description": "Параметры запроса создания заказа билетов", "properties": { "name": { "type": "string", "example": "Петя Иванов" }, "city": { "type": "string", "example": "Москва" }, "club_name": { "type": "string", "example": "Clubchik" }, "phone": { "type": "string", "example": "+79998887755" }, "email": { "type": "string", "example": "some@email.com" } }, "type": "object" }, "CreateMeetupPaymentFormRequest": { "description": "Параметры запроса оплаты", "properties": { "orderUuid": { "type": "string", "example": "8849d46e-1219-4004-9f62-23575b48cab7" }, "method": { "type": "string", "enum": [ "SBP", "CARD", "PAYZE" ] } }, "type": "object" }, "ROrder": { "properties": { "status": { "type": "boolean", "example": "true" }, "orderUuid": { "type": "string", "example": "0346fd8e-dd90-4c01-9b9a-1be417db4498" }, "orderAmount": { "type": "number", "example": "8000" } }, "type": "object" }, "RMeetupOrder": { "properties": { "status": { "type": "boolean", "example": "true" }, "orderUuid": { "type": "string", "example": "0346fd8e-dd90-4c01-9b9a-1be417db4498" }, "orderAmount": { "type": "number", "example": "8000" } }, "type": "object" } }, "securitySchemes": { "bearerAuth": { "type": "http", "name": "Authorization", "in": "header", "scheme": "bearer" }, "externalToken": { "type": "apiKey", "name": "x-api-token", "in": "header", "scheme": "bearer" } } }, "tags": [ { "name": "Auth", "description": "Авторизация" }, { "name": "App.Clubs", "description": "App. Работа с клубами" }, { "name": "Personal.Clubs", "description": "ЛК. Работа с клубами" }, { "name": "Conference", "description": "Конференция" }, { "name": "Documents", "description": "Documents" }, { "name": "External", "description": "External" }, { "name": "Forms", "description": "Forms" }, { "name": "GEO", "description": "GEO" }, { "name": "Offers", "description": "Offers" }, { "name": "Meetup", "description": "Meetup" } ] }