3. Создание задачи (POST /create_task)
Выгрузка для ИИ (JSON)Метод ставит задачу в очередь и возвращает request_id. Фактический расчёт выполняется worker-процессом асинхронно.
# 3. Создание задачи (POST /create_task)
Endpoint
POST/api.php?action=create_task
Request body schema
# Параметры верхнего уровня
| Поле / Параметр | Тип | Описание |
|---|---|---|
| api_key* | string | number | Ключ доступа API (публичный тестовый: 655351024). |
| calc_profile | enum | Профиль расчёта весов для synthesis. Приоритет источников: X-Calc-Profile > query > body > default. По умолчанию: A [A, B] |
| user* | object | Натальные данные пользователя (SubjectContext). |
| systems | array[string] | Список модулей: numerology, astrology, bodygraph, transits, forecast, synthesis. |
| current_location | object | Текущая локация для TemporalContext (прогнозы/транзиты/дневные ветки). |
| forecast | object | Параметры периода прогноза и режим качества space_weather. |
| response | object | Опции проекции ответа (например, omit_portrait_payload). |
# Объект user
| Поле / Параметр | Тип | Описание |
|---|---|---|
| first_name* | string | Пример: Евгений |
| last_name* | string | Пример: Ефимченко |
| middle_name | string | Пример: Владимирович |
| birth_date* | string (date) | Пример: 1981-10-27 |
| birth_time* | string (time) | Пример: 04:13 |
| birth_city* | string | Пример: Норильск |
| birth_country | string | Пример: Россия |
# Объект forecast
| Поле / Параметр | Тип | Описание |
|---|---|---|
| period_type | enum | Тип периода прогноза. По умолчанию: day [day, week, month] |
| period_start_date | string (date) | Дата начала периода (алиас target_date). Пример: 2026-02-14 |
| target_time | string (time) | Время якоря расчёта для TemporalContext. Пример: 12:00:00 |
| space_weather_mode | enum | Режим качества Kp-данных. По умолчанию: allow_simulated [allow_simulated, observed_or_estimated, observed_only] |
# Объект response
| Поле / Параметр | Тип | Описание |
|---|---|---|
| omit_portrait_payload | boolean | Если true, в итоговом payload скрываются тяжёлые портретные ветки systems.numerology/astrology/bodygraph. По умолчанию: |
# Практические рекомендации
List
- •Чтобы получить канонический слой, добавьте "synthesis" в systems.
- •Подробный разбор режимов summary/explain/raw вынесен в раздел «5. Работа с Synthesis++ (IPSM v2)».
- •Если нужен компактный ответ, передавайте response.omit_portrait_payload=true.
Пример
Запрос с synthesis и компактным режимом ответа.
Ответjson
{
"api_key": "655351024",
"calc_profile": "B",
"user": {
"first_name": "Евгений",
"middle_name": "Владимирович",
"last_name": "Ефимченко",
"birth_date": "1981-10-27",
"birth_time": "04:13",
"birth_city": "Норильск",
"birth_country": "Россия"
},
"systems": [
"numerology",
"astrology",
"bodygraph",
"transits",
"forecast",
"synthesis"
],
"current_location": {
"city": "Орел",
"country": "Россия"
},
"forecast": {
"period_type": "day",
"period_start_date": "2026-02-14",
"target_time": "12:00:00",
"space_weather_mode": "observed_or_estimated"
},
"response": {
"omit_portrait_payload": true
}
}Пример
Задача поставлена в очередь.
Ответjson
{
"status": "queued",
"message": "Task accepted",
"request_id": "task_698cdc670473d"
}Пример
Ошибка валидации обязательных полей user.
Ответjson
{
"status": "error",
"errors": [
"Field 'last_name' is required"
]
}