Методы API
DEVELOPER PLATFORM · v1

API, с которым удобно работать

CRM, кампании, аналитика и интеграции. Точные контракты, понятные примеры и подписанные вебхуки.

Скачать OpenAPI

Private preview: API доступен с проектным ключом. Публичные SLA и сроки поддержки ещё не установлены.

От ключа до первого запроса

Создайте отдельный ключ для каждой интеграции. Он связан с одним проектом; projectId в запросе не передаётся.

  1. Войдите в проект → Настройки → Developer API. Владелец включает «API проекта»; в разделе «Модули» включите «Контакты» для первого примера. Для выдачи ключа нужны права управления настройками; если в аккаунте включена TOTP, понадобится текущий код.
  2. Форма ключа включает пять базовых CRM read scopes, в том числе crm.clients.read. Добавляйте write scopes только по необходимости. Сохраните токен в secret manager: он показывается один раз при создании или ротации.
  3. Замените YOUR_NOVA_HOST и YOUR_PROJECT_TOKEN в примере. /api — базовый путь, /v1 — версия REST API.
curl 'https://YOUR_NOVA_HOST/api/v1/developer/crm/clients?limit=25' \
  --header 'Authorization: Bearer YOUR_PROJECT_TOKEN'

Ключ нельзя передавать в URL, клиентский JavaScript или логи. Bearer не даёт права выдавать и отзывать ключи. Отзыв доступа создателя ключа и отключение модуля также могут остановить интеграцию.

Sandbox

В сборках с поддержкой sandbox настройки Developer API позволяют создать отдельный тестовый проект и его ключ. Это ограниченный non-production проект; платежи, live-доставка и внешние Integration credentials недоступны. Возможность CRM API или webhook зависит от выбранных модулей. Публичный портал не отправляет запросы от вашего имени.