Метод
POST https://varica.ru/api/v2/pages
Content-Type: multipart/form-data
X-Api-Key: YOUR_API_KEY
Метод берёт шаблон указанной организации, подставляет данные, создаёт неизменяемую публичную страницу и списывает стоимость создания КП с баланса пространства.
Поля формы
| Поле | Обязательное | Формат | Назначение |
|---|---|---|---|
template_id |
да | целое число | ID шаблона из кабинета VARICA |
source_entity_id |
да | строка до 255 символов | ID исходной сущности CRM/внешней системы |
page_slug |
нет | латиница, цифры, _, -, 3–64 символа |
Внутренний slug страницы; уникален внутри пространства |
data.<mask> |
зависит от шаблона | строка | Значение обычной маски |
rows.<mask> |
зависит от Table v2 | строка с | |
Набор значений для строк таблицы |
Важно: source_entity_id сейчас обязательный. Он связывает несколько созданных КП с одной сущностью и нужен для последующего entity-results.
Полный пример
curl -X POST "https://varica.ru/api/v2/pages" \
-H "X-Api-Key: YOUR_API_KEY" \
-F "template_id=134" \
-F "source_entity_id=deal_7821" \
-F "data.client.name=АО Транскемикл-экспресс" \
-F "data.deal.title=Защита металлоконструкций" \
-F "data.deal.amount=100 750,20" \
-F "data.manager.name=Алексей Турковский" \
-F "data.manager.phone=t.me/turkovskiy" \
-F "rows.tables.name=Цинкование|Подготовка поверхности" \
-F "rows.tables.count=100|200" \
-F "rows.tables.unit=м²|м²" \
-F "rows.tables.price=500,20|210,00" \
-F "rows.tables.total=50 020,00|42 000,00"
Кавычки, запятые и русский текст допустимы в значениях полей. Сервис не разбивает их на строки: единственный разделитель строк таблицы — символ |.
Успешный ответ
HTTP 201 Created:
{
"page_id": 4012,
"url": "https://varica.ru/Qf8xLm.varica_lab.offer_for_deal_7821",
"pdf_url": "https://varica.ru/Qf8xLm.varica_lab.offer_for_deal_7821/download.pdf",
"page_slug": "kp9a31df"
}
| Поле | Значение |
|---|---|
page_id |
Внутренний ID созданной страницы. Не использовать для построения публичной ссылки. |
url |
Готовая ссылка для клиента. |
pdf_url |
Ссылка, по которой сразу начинается создание и скачивание PDF. PDF постоянно не хранится. |
page_slug |
Фактический slug страницы: переданный или сгенерированный сервисом. |
Что происходит внутри
- API-ключ определяет организацию.
- Шаблон ищется только внутри этой организации.
- Сервис проверяет обязательные маски в теме и теле шаблона.
- Table v2 разворачивает строки
rows.*. - Результат сохраняется как snapshot.
- Создаётся случайный публичный token, независимый от
page_id. - С баланса списывается стоимость создания страницы.
Созданная ссылка не меняет своё содержимое при последующем редактировании шаблона.