Дополнительно · API Access

REST API cero

Сайт, лендинг или своя система компании передают лиды и заявки в cero — и AI-сотрудник сразу начинает с ними работать по процессам компании.

Доступ

Ключ организации

Владелец создаёт ключ в «Настройки → API-ключи» на cero.uz и выбирает права (scopes). Ключ показывается один раз; в базе хранится только его SHA-256 отпечаток. Отозванный, просроченный и несуществующий ключи получают одинаковый ответ.

Запрос

Базовый адрес: https://cero.uz/api/v1. Ключ передаётся в заголовке:

Authorization: Bearer awp_…

Ключ проверяется до чтения тела запроса; организация берётся из ключа, никогда из запроса.

Эндпоинты

Метод	Путь	Что делает
`POST`	`/api/v1/leads`	Создать лид: контакт находится или создаётся, лид распределяется по правилам и запускает процессы компании
`GET`	`/api/v1/leads`	Список лидов с пагинацией (`limit`, `offset`) и фильтром `status`
`POST`	`/api/v1/applications`	Создать заявку: запускает AI-квалификацию и процесс компании
`GET`	`/api/v1/applications`, `/api/v1/applications/{id}`	Заявки, их статус, балл и решение
`GET`	`/api/v1/conversations`	Переписки по всем каналам
`GET`	`/api/v1/partners`	Партнёры (для партнёрских программ)

Пример: лид с сайта

curl -X POST https://cero.uz/api/v1/leads \
  -H "Authorization: Bearer $CERO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Дилноза Каримова",
    "phone": "+998 90 123 45 67",
    "email": "dilnoza@example.uz",
    "title": "Запрос на консультацию",
    "source": "landing",
    "utmSource": "instagram",
    "utmCampaign": "autumn-2026"
  }'

Поля: fullName, email, phone (нужен хотя бы один из двух), companyName, title, source, utmSource, utmMedium, utmCampaign, landingPage, channel, metadata.

Ключ — секрет организации: храните его на своём сервере, а не в коде страницы. Лимиты тарифа проверяются до записи; без ключа API отвечает 401, без нужного права — 403.