Программный интерфейс
/api/reference/context_browser/search
/api/reference/context_browser/search
Страница собрана из снимка JSON Schema в репозитории документации. Снимок обновляется отдельной командой из каталога основного приложения и при сборке сайта не переписывается.
Запрос
main-app://schemas/api_references/context_browser/search.request.json
REQUEST /api/reference/context_browser/search
| Имя | Тип | Обязательное | Ограничение |
|---|---|---|---|
filters | array of object | Нет | - |
options | object | Нет | другие поля допустимы |
response | any | Нет | - |
Другие поля верхнего уровня допустимы.
filters[]
| Имя | Тип | Обязательное | Ограничение |
|---|---|---|---|
object | object | Да | другие поля допустимы |
operator | string | Да | - |
value | any | Нет | - |
filters[].object
| Имя | Тип | Обязательное | Ограничение |
|---|---|---|---|
element | string | Да | - |
attribute | string | Да | - |
options
| Имя | Тип | Обязательное | Ограничение |
|---|---|---|---|
add | array of string | Нет | - |
Ответ
main-app://schemas/api_references/context_browser/search.response.json
RESPONSE /api/reference/context_browser/search
| Имя | Тип | Обязательное | Ограничение |
|---|---|---|---|
api_code | integer | Да | const 200 |
api_result | array of object | boolean | Да | - |
empty | boolean | Нет | - |
Другие поля верхнего уровня запрещены.
Исходная схема
Файлы ниже скопированы из снимка без изменений. Фрагмент по $ref приведён отдельным блоком, схемы не сливаются.
Запрос: main-app://schemas/api_references/context_browser/search.request.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/api_references/context_browser/search.request.json",
"title": "REQUEST /api/reference/context_browser/search",
"$ref": "main-app://schemas/_shared/search.request.json"
}Фрагмент: main-app://schemas/_shared/search.request.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/_shared/search.request.json",
"title": "Typical /web_api/{entity}/search body",
"type": "object",
"properties": {
"filters": {
"type": "array",
"items": {
"type": "object",
"required": ["object", "operator"],
"properties": {
"object": {
"type": "object",
"required": ["element", "attribute"],
"properties": {
"element": { "type": "string" },
"attribute": { "type": "string" }
},
"additionalProperties": true
},
"operator": { "type": "string" },
"value": true
},
"additionalProperties": true
}
},
"options": {
"type": "object",
"properties": {
"add": {
"type": "array",
"items": { "type": "string" }
}
},
"additionalProperties": true
},
"response": true
},
"additionalProperties": true
}Ответ: main-app://schemas/api_references/context_browser/search.response.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/api_references/context_browser/search.response.json",
"title": "RESPONSE /api/reference/context_browser/search",
"$ref": "main-app://schemas/_shared/search.response.json"
}Фрагмент: main-app://schemas/_shared/search.response.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/_shared/search.response.json",
"title": "Typical search success. Empty list is api_result false, not [].",
"allOf": [
{ "$ref": "main-app://schemas/_shared/envelope-success.json" },
{
"type": "object",
"properties": {
"api_result": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{ "const": false }
]
}
}
}
]
}Фрагмент: 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
}Страница не помогла?