Программный интерфейс

/web_api/public/helpdesk/tickets

/web_api/public/helpdesk/tickets ​

Страница собрана из снимка JSON Schema в репозитории документации. Снимок обновляется отдельной командой из каталога основного приложения и при сборке сайта не переписывается.

Запрос ​

main-app://schemas/api_public_helpdesk/tickets.request.json

POST /web_api/public/helpdesk/tickets body

ИмяТипОбязательноеОграничение
display_namestringДа-
contact_method_keystringДа-
contact_valuestringДа-
bodystringДа-
pdn_consentanyДа-
localestringНет-
source_page_urlstringНет-
utm_sourcestringНет-
utm_mediumstringНет-
utm_campaignstringНет-
utm_contentstringНет-
utm_termstringНет-
yclidstringНет-
visitor_keystringНет-

Другие поля верхнего уровня допустимы.

Ответ ​

main-app://schemas/api_public_helpdesk/tickets.response.json

POST /web_api/public/helpdesk/tickets success

ИмяТипОбязательноеОграничение
api_codeintegerДаconst 200
api_resultobjectДадругие поля допустимы
emptybooleanНет-

Другие поля верхнего уровня запрещены.

Исходная схема ​

Файлы ниже скопированы из снимка без изменений. Фрагмент по $ref приведён отдельным блоком, схемы не сливаются.

Запрос: main-app://schemas/api_public_helpdesk/tickets.request.json
json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "main-app://schemas/api_public_helpdesk/tickets.request.json",
  "title": "POST /web_api/public/helpdesk/tickets body",
  "type": "object",
  "required": [
    "display_name",
    "contact_method_key",
    "contact_value",
    "body",
    "pdn_consent"
  ],
  "additionalProperties": true,
  "properties": {
    "display_name": {
      "type": "string"
    },
    "contact_method_key": {
      "type": "string"
    },
    "contact_value": {
      "type": "string"
    },
    "body": {
      "type": "string"
    },
    "pdn_consent": true,
    "locale": {
      "type": "string"
    },
    "source_page_url": {
      "type": "string"
    },
    "utm_source": {
      "type": "string"
    },
    "utm_medium": {
      "type": "string"
    },
    "utm_campaign": {
      "type": "string"
    },
    "utm_content": {
      "type": "string"
    },
    "utm_term": {
      "type": "string"
    },
    "yclid": {
      "type": "string"
    },
    "visitor_key": {
      "type": "string"
    }
  }
}
Ответ: main-app://schemas/api_public_helpdesk/tickets.response.json
json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "main-app://schemas/api_public_helpdesk/tickets.response.json",
  "title": "POST /web_api/public/helpdesk/tickets success",
  "allOf": [
    {
      "$ref": "main-app://schemas/_shared/envelope-success.json"
    },
    {
      "type": "object",
      "properties": {
        "api_result": {
          "type": "object",
          "additionalProperties": true
        }
      }
    }
  ]
}
Фрагмент: main-app://schemas/_shared/envelope-success.json
json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "main-app://schemas/_shared/envelope-success.json",
  "title": "Canonical success envelope",
  "type": "object",
  "required": ["api_code", "api_result"],
  "properties": {
    "api_code": { "const": 200 },
    "api_result": true,
    "empty": { "type": "boolean" }
  },
  "additionalProperties": false
}

Версия 1.0.0 · Последнее изменение 2026-10-07

Страница не помогла?