{ "swagger": "2.0", "info": { "description": "Публичное HTTP API sinde.ru. Мутирующие запросы аутентифицированной зоны требуют cookie-сессию и заголовок X-CSRF-Token.", "title": "SINDE API", "contact": {}, "version": "1.0" }, "basePath": "/", "paths": { "/api/v1/auth/admin/keys/meta/update": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "keys" ], "summary": "Обновить meta ключа по ID (только администратор)", "parameters": [ { "description": "id, meta", "name": "body", "in": "body", "required": true, "schema": { "type": "object" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "401": { "description": "Unauthorized", "schema": { "type": "object", "additionalProperties": true } }, "403": { "description": "Forbidden", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/chemistry/elements": { "get": { "produces": [ "application/json" ], "tags": [ "chemistry" ], "summary": "Список химических элементов", "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/keys/enum/options": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "keys" ], "summary": "Enum-опции по syn", "parameters": [ { "description": "syn", "name": "body", "in": "body", "required": true, "schema": { "type": "object" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/keys/meta": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "keys" ], "summary": "Meta ключа по одному syn", "parameters": [ { "description": "syn", "name": "body", "in": "body", "required": true, "schema": { "type": "object" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/keys/meta/all": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "keys" ], "summary": "Все meta по списку syn", "parameters": [ { "description": "syns: список синонимов", "name": "body", "in": "body", "required": true, "schema": { "type": "object" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/keys/meta/bulk": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "keys" ], "summary": "Meta по списку ID", "parameters": [ { "description": "ids: список ID ключей", "name": "body", "in": "body", "required": true, "schema": { "type": "object" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/materials": { "get": { "produces": [ "application/json" ], "tags": [ "materials" ], "summary": "Список материалов: поиск и фильтры", "parameters": [ { "type": "string", "description": "Поисковая строка", "name": "q", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/materials/meta": { "get": { "produces": [ "application/json" ], "tags": [ "materials" ], "summary": "Свойства и категории материалов", "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/materials/{slug}": { "get": { "produces": [ "application/json" ], "tags": [ "materials" ], "summary": "Карточка материала", "parameters": [ { "type": "string", "description": "Slug материала", "name": "slug", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/minerals": { "get": { "produces": [ "application/json" ], "tags": [ "minerals" ], "summary": "Список минералов: поиск и фильтры", "parameters": [ { "type": "string", "description": "Поисковая строка", "name": "q", "in": "query" }, { "type": "integer", "description": "Страница", "name": "page", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/minerals/{database_id}": { "get": { "produces": [ "application/json" ], "tags": [ "minerals" ], "summary": "Карточка минерала", "parameters": [ { "type": "string", "description": "ID минерала в базе", "name": "database_id", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/sets": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "sets" ], "summary": "Создать набор особенностей", "parameters": [ { "description": "childs: список t_uuid", "name": "body", "in": "body", "required": true, "schema": { "type": "object" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/sets/find": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "sets" ], "summary": "Найти или создать набор по списку особенностей", "parameters": [ { "description": "childs: список t_uuid", "name": "body", "in": "body", "required": true, "schema": { "type": "object" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/sets/{uuid}": { "get": { "produces": [ "application/json" ], "tags": [ "sets" ], "summary": "Получить набор по UUID", "parameters": [ { "type": "string", "description": "UUID набора", "name": "uuid", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/sets/{uuid}/stream": { "get": { "produces": [ "application/json" ], "tags": [ "sets" ], "summary": "Потоковая выдача набора (NDJSON)", "parameters": [ { "type": "string", "description": "UUID набора", "name": "uuid", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/traits": { "post": { "consumes": [ "application/json" ], "produces": [ "application/json" ], "tags": [ "traits" ], "summary": "Создать особенность или вернуть существующую", "parameters": [ { "description": "t_key, t_value, meta (опционально)", "name": "body", "in": "body", "required": true, "schema": { "type": "object" } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "400": { "description": "Bad Request", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/traits/resolve/{uuid}": { "get": { "produces": [ "application/json" ], "tags": [ "traits" ], "summary": "Разрешить UUID в особенность или набор", "parameters": [ { "type": "string", "description": "UUID особенности или набора", "name": "uuid", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": true } } } } }, "/api/v1/traits/{uuid}": { "get": { "produces": [ "application/json" ], "tags": [ "traits" ], "summary": "Получить особенность по UUID", "parameters": [ { "type": "string", "description": "UUID особенности", "name": "uuid", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "404": { "description": "Not Found", "schema": { "type": "object", "additionalProperties": true } } } } }, "/healthz": { "get": { "produces": [ "application/json" ], "tags": [ "health" ], "summary": "Liveness-проба", "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } } } } }, "/readyz": { "get": { "produces": [ "application/json" ], "tags": [ "health" ], "summary": "Readiness-проба (Postgres, Redis)", "responses": { "200": { "description": "OK", "schema": { "type": "object", "additionalProperties": true } }, "503": { "description": "Service Unavailable", "schema": { "type": "object", "additionalProperties": true } } } } } } }