novafon-api

# 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 '.'