Demerzels-lab # Novafon API 📞
Novafon предоставляет два JSON-RPC API — **Data API** для доступа к данным и отчётам, и **Call API** для создания и управления звонками. :contentReference[oaicite:1]{index=1}
## 🔑 Настройка
### 📦 Переменные окружения
| Variable | Description | Required |
|----------|-------------|----------|
| NOVAFON\_DATA\_API\_URL | Base URL Data API (обычно dataapi-jsonrpc.novofon.ru/v2.0) | Yes |
| NOVAFON\_CALL\_API\_URL | Base URL Call API (обычно callapi-jsonrpc.novofon.ru/v4.0) | Yes |
| NOVAFON\_API\_TOKEN | Доступный **access_token** (ключ API или сессия) | Yes |
## 🧠 Общие сведения
📌 Обе API используют **JSON-RPC 2.0** (метод POST, тело запроса JSON). :contentReference[oaicite:2]{index=2}
📌 Все параметры и поля — **snake_case**. :contentReference[oaicite:3]{index=3}
📌 Требуется добавление IP в белый список в админ-панели. :contentReference[oaicite:4]{index=4}
## 🗂 Data API — работа с данными и отчётами
### 📌 Основные принципы
- Базовый URL: ${NOVAFON\_DATA\_API\_URL} → JSON-RPC запросы. :contentReference[oaicite:5]{index=5}
- Обработка ошибок подробно описана (коды, мнемоники). :contentReference[oaicite:6]{index=6}
- Поддерживаются фильтрация, сортировка и пагинация. :contentReference[oaicite:7]{index=7}
### 📊 📈 📉 Базовые запросы
\# Пример базового запроса Data API
curl -s "${NOVAFON\_DATA\_API\_URL}" \\
-H "Content-Type: application/json" \\
-d '{
"jsonrpc":"2.0",
"id":"req1",
"method":"get.account",
"params":{
"access\_token":"'"${NOVAFON\_API\_TOKEN}"'"
}
}' | jq '.'