HPT.SU API

openapi: 3.1.0
info:
  title: HPT.SU API
  version: '2026-11-11'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-11: 44 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; HPT.SU has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 44
    pages-with-code: 0
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-11'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://hpt.su/api/v1/docs/swagger
paths:
  /api/v1/docs/:
    get:
      operationId: get_api_v1_docs
      tags:
      - Api
      summary: Глобальный поиск по всем базам документов
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/by_vin/{vin}/:
    get:
      operationId: get_api_v1_docs_by_vin_vin
      tags:
      - Api
      summary: Поиск документов по VIN во всех базах сразу
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: vin
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/cert/:
    get:
      operationId: get_api_v1_docs_cert
      tags:
      - Api
      summary: Список сертификатов соответствия
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/cert/{slug}/:
    get:
      operationId: get_api_v1_docs_cert_slug
      tags:
      - Api
      summary: Получить сертификат по slug
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/decl/:
    get:
      operationId: get_api_v1_docs_decl
      tags:
      - Api
      summary: Список деклараций о соответствии
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/decl/{slug}/:
    get:
      operationId: get_api_v1_docs_decl_slug
      tags:
      - Api
      summary: Получить декларацию по slug
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/fulltext/:
    get:
      operationId: get_api_v1_docs_fulltext
      tags:
      - Api
      summary: Полнотекстовый поиск по документам одобрения типа
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/otch/:
    get:
      operationId: get_api_v1_docs_otch
      tags:
      - Api
      summary: Список ОТШ
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/otch/{slug}/:
    get:
      operationId: get_api_v1_docs_otch_slug
      tags:
      - Api
      summary: Получить ОТШ по slug
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/otts/{slug}:
    get:
      operationId: get_api_v1_docs_otts_slug
      tags:
      - Api
      summary: Получить ОТТС по slug
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/sbkts:
    get:
      operationId: get_api_v1_docs_sbkts
      tags:
      - Api
      summary: Список СБКТС
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Количество элементов на странице
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Смещение от начала списка
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/sbkts/{slug}:
    get:
      operationId: get_api_v1_docs_sbkts_slug
      tags:
      - Api
      summary: Получить СБКТС по slug
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/sout:
    get:
      operationId: get_api_v1_docs_sout
      tags:
      - Api
      summary: Список СУТ
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Количество элементов на странице
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Смещение от начала списка
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/sout/{slug}:
    get:
      operationId: get_api_v1_docs_sout_slug
      tags:
      - Api
      summary: Получить СУТ по slug
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/zoets:
    get:
      operationId: get_api_v1_docs_zoets
      tags:
      - Api
      summary: Список ЗОЕТС
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Количество элементов на странице
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Смещение от начала списка
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/zoets/{slug}:
    get:
      operationId: get_api_v1_docs_zoets_slug
      tags:
      - Api
      summary: Получить ЗОЕТС по slug
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/zotch:
    get:
      operationId: get_api_v1_docs_zotch
      tags:
      - Api
      summary: Список ЗОТШ
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Количество элементов на странице
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Смещение от начала списка
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/zotch/{slug}:
    get:
      operationId: get_api_v1_docs_zotch_slug
      tags:
      - Api
      summary: Получить ЗОТШ по slug
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/zotts:
    get:
      operationId: get_api_v1_docs_zotts
      tags:
      - Api
      summary: Список ЗОТТС
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Количество элементов на странице
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Смещение от начала списка
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/zotts/{slug}:
    get:
      operationId: get_api_v1_docs_zotts_slug
      tags:
      - Api
      summary: Получить ЗОТТС по slug
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/docs/{kind}/{documentSlug}/files/:
    get:
      operationId: get_api_v1_docs_kind_documentSlug_files
      tags:
      - Api
      summary: Список файлов документа
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: kind
        in: path
        required: true
        schema:
          type: string
      - name: documentSlug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/files/{uid}/download/:
    post:
      operationId: post_api_v1_files_uid_download
      tags:
      - Api
      summary: Получить ссылки на файл документа
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: uid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/kinds:
    get:
      operationId: get_api_v1_kinds
      tags:
      - Api
      summary: Список типов документов
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Количество элементов на странице
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Смещение от начала списка
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/mcp/whoami/:
    get:
      operationId: get_api_v1_mcp_whoami
      tags:
      - Api
      summary: Проверка ключа или токена
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1McpWhoamiResponse'
      x-evidence:
        kind: documentation
  /api/v1/nsi/axis-counts/:
    get:
      operationId: get_api_v1_nsi_axis_counts
      tags:
      - Api
      summary: Количество осей/колёс
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/axis-counts/{id}/:
    get:
      operationId: get_api_v1_nsi_axis_counts_id
      tags:
      - Api
      summary: Получить запись осей/колёс по id
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/brands/:
    get:
      operationId: get_api_v1_nsi_brands
      tags:
      - Api
      summary: Марки ТС
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/brands/{id}/:
    get:
      operationId: get_api_v1_nsi_brands_id
      tags:
      - Api
      summary: Получить марку ТС по id
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/certification-bodies/:
    get:
      operationId: get_api_v1_nsi_certification_bodies
      tags:
      - Api
      summary: Органы по сертификации
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/certification-bodies/{id}/:
    get:
      operationId: get_api_v1_nsi_certification_bodies_id
      tags:
      - Api
      summary: Получить орган сертификации по id
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/eco-classes/:
    get:
      operationId: get_api_v1_nsi_eco_classes
      tags:
      - Api
      summary: Эко-классы ТС
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/eco-classes/{id}/:
    get:
      operationId: get_api_v1_nsi_eco_classes_id
      tags:
      - Api
      summary: Получить эко-класс по id
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/test-labs/:
    get:
      operationId: get_api_v1_nsi_test_labs
      tags:
      - Api
      summary: Испытательные лаборатории
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/test-labs/{id}/:
    get:
      operationId: get_api_v1_nsi_test_labs_id
      tags:
      - Api
      summary: Получить лабораторию по id
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/tnved/:
    get:
      operationId: get_api_v1_nsi_tnved
      tags:
      - Api
      summary: ТН ВЭД ЕАЭС
      x-source: https://hpt.su/api/v1/docs/swagger
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/tnved/{id}/:
    get:
      operationId: get_api_v1_nsi_tnved_id
      tags:
      - Api
      summary: Получить код ТН ВЭД по id
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/nsi/vehicle-models/:
    get:
      operationId: get_api_v1_nsi_vehicle_models
      tags:
      - Api
      summary: Модели ТС
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Количество записей на странице
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Смещение от начала списка
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1NsiVehicleModelsResponse'
      x-evidence:
        kind: documentation
  /api/v1/nsi/vehicle-models/{id}/:
    get:
      operationId: get_api_v1_nsi_vehicle_models_id
      tags:
      - Api
      summary: Получить модель ТС по id
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1NsiVehicleModelsIdResponse'
      x-evidence:
        kind: documentation
  /api/v1/nsi/wheel-formulas/:
    get:
      operationId: get_api_v1_nsi_wheel_formulas
      tags:
      - Api
      summary: Колёсные формулы
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Количество записей на странице
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Смещение от начала списка
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1NsiWheelFormulasResponse'
      x-evidence:
        kind: documentation
  /api/v1/nsi/wheel-formulas/{id}/:
    get:
      operationId: get_api_v1_nsi_wheel_formulas_id
      tags:
      - Api
      summary: Получить колёсную формулу по id
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1NsiWheelFormulasIdResponse'
      x-evidence:
        kind: documentation
  /api/v1/uploads/:
    get:
      operationId: get_api_v1_uploads
      tags:
      - Api
      summary: Мои загрузки
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Количество записей на странице
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Смещение от начала списка
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1UploadsResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_v1_uploads
      tags:
      - Api
      summary: Загрузить документ
      x-source: https://hpt.su/api/v1/docs/swagger
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1UploadsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1UploadsResponse'
      x-evidence:
        kind: documentation
  /api/v1/uploads/{uid}/:
    get:
      operationId: get_api_v1_uploads_uid
      tags:
      - Api
      summary: Моя загрузка
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: uid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1UploadsUidResponse'
      x-evidence:
        kind: documentation
  /api/v1/uploads/{uid}/withdraw/:
    post:
      operationId: post_api_v1_uploads_uid_withdraw
      tags:
      - Api
      summary: Отозвать загрузку
      x-source: https://hpt.su/api/v1/docs/swagger
      parameters:
      - name: uid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1UploadsUidWithdrawResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV1McpWhoamiResponse:
      type: object
      properties:
        user_id:
          type: string
        valid:
          type: boolean
    GetApiV1NsiVehicleModelsResponse:
      type: object
      properties:
        results:
          type: array
          description: Список моделей ТС
        count:
          type: integer
          description: Общее количество записей
    GetApiV1NsiVehicleModelsIdResponse:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
    GetApiV1NsiWheelFormulasResponse:
      type: object
      properties:
        results:
          type: array
          description: Список колёсных формул
        count:
          type: integer
          description: Общее количество записей
    GetApiV1NsiWheelFormulasIdResponse:
      type: object
      properties:
        id:
          type: integer
        formula:
          type: string
    GetApiV1UploadsResponse:
      type: object
      properties:
        results:
          type: array
          description: Список загрузок
        count:
          type: integer
          description: Общее количество записей
    PostApiV1UploadsRequest:
      type: object
      properties:
        file:
          type: string
          description: Файл документа
        metadata:
          type: object
          description: Дополнительные метаданные
      required:
      - file
    PostApiV1UploadsResponse:
      type: object
      properties:
        uid:
          type: string
          description: Уникальный идентификатор загрузки
        status:
          type: string
          description: Статус загрузки
    GetApiV1UploadsUidResponse:
      type: object
      properties:
        uid:
          type: string
        status:
          type: string
        created_at:
          type: string
          description: Дата создания
    PostApiV1UploadsUidWithdrawResponse:
      type: object
      properties:
        uid:
          type: string
        status:
          type: string
          description: Новый статус после отзыва
tags:
- name: Api