Программный интерфейс
/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_name | string | Да | - |
contact_method_key | string | Да | - |
contact_value | string | Да | - |
body | string | Да | - |
pdn_consent | any | Да | - |
locale | string | Нет | - |
source_page_url | string | Нет | - |
utm_source | string | Нет | - |
utm_medium | string | Нет | - |
utm_campaign | string | Нет | - |
utm_content | string | Нет | - |
utm_term | string | Нет | - |
yclid | string | Нет | - |
visitor_key | string | Нет | - |
Другие поля верхнего уровня допустимы.
Ответ
main-app://schemas/api_public_helpdesk/tickets.response.json
POST /web_api/public/helpdesk/tickets success
| Имя | Тип | Обязательное | Ограничение |
|---|---|---|---|
api_code | integer | Да | const 200 |
api_result | object | Да | другие поля допустимы |
empty | boolean | Нет | - |
Другие поля верхнего уровня запрещены.
Исходная схема
Файлы ниже скопированы из снимка без изменений. Фрагмент по $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
}Страница не помогла?