API: Создание черновика КП

POST https://www.getkp.ru/api/genpage

Требует авторизации через Bearer Token (получить токен)

Описание

Создаёт черновик документа (КП) на основе выбранного шаблона. Используйте этот метод для автоматизированного создания КП через ваш сервис или сторонние приложения.

Параметры запроса

template_id	string	да	ID шаблона. Пользователь должен иметь доступ к шаблону (создан им или командный)
title	string	нет	Название КП (по умолчанию "Новое КП")
vars	JSON array	нет	Массив значений переменных для вставки в шаблон в виде массива пар "ключ" : "значение"
ai_prompt	string	нет	Текст-подсказка для ИИ. Пояснение: Введите здесь подробности о вашем клиенте, которые могут помочь искусственному интеллекту сделать коммерческое предложение максимально персонализированным. Например, сферу деятельности клиента, его основные задачи, проблемы, потребности, цели или детали вашего взаимодействия с ним. Пример: «Клиент — сеть розничных магазинов бытовой техники, основная проблема — большая текучка персонала и отсутствие автоматизации складских процессов. Задача — повысить эффективность работы склада и сократить ошибки при отгрузке товаров».
input_data	string	нет	Дополнительные данные для ИИ или шаблона. Пояснение: Укажите любые рекомендации, которые позволят ИИ сгенерировать КП наиболее подходящим образом под задачи клиента. Это могут быть особенности стиля, запреты, ключевые акценты или детали, которые обязательно нужно учесть. Пример: «Обратить особое внимание на экономию времени для клиента, избегать сложных технических терминов, добавить конкретные примеры внедрения в розничной торговле.»

Пример запроса

POST  https://getkp.ru/api/genpage
Authorization: Bearer {token}
Content-Type: application/json
{
   "template_id": "01kfmr84vg4szat1fsckcsm8t6",
   "title": "КП для ООО Ромашка",
   "vars": {
      "client": "ООО Ромашка",
      "date": "2026-01-25"
   },
   "ai_prompt": "Оформить как email",
   "input_data": "Текст для генерации"
}

Формат ответа

{
    "success": true,
    "genpage_id": "01kfmr84vg4szat1fsckcsm8t6"
}

Далее пользователь может переходить по ссылке: https://getkp.ru/pages/{genpage_id}/edit

для отправки страницы на генерацию

Формат успешного ответа

{

"success": true,

"genpage_id": 123

}

Возможные ошибки

Например, если не указан или неверен template_id:

{

"message": "The template id field is required.",

"errors": {

"template_id": [

"The selected template id is invalid."

]

}

}

Примечания

Все поля, кроме template_id, опциональные.

Для авторизации используйте токен пользователя.

Если требуется добавить дополнительные поля — укажите их как элементы массива vars.