REST API Neiros

Авторизация: получаем токен

Все запросы к API требуют авторизации через Bearer-токен. Для его получения выполните POST-запрос:

URL:

Пример тела запроса:

{
  "email": "test@test.ru",
  "password": "123456"
}

Пример ответа:

{
  "token": "323|RvUxhGGOpHatTfGvoIuTSXV9AmF6CqX3GMhpc5EH"
}

Добавляйте токен в заголовок всех запросов:

Authorization: Bearer {TOKEN}

С чего начать

После авторизации вы можете:

• получить список подключённых сайтов;
• получить список сделок по сайту;
• запросить детали конкретной сделки;
• изменить сумму сделки.

Вот как это выглядит на практике:

Получить список сайтов

Это может понадобиться, если вы обслуживаете несколько проектов в одной учётке Neiros.

GET /api/userapi/v1/sites

Ответ:

[
  {"name": "example.ru", "id": 100},
  {"name": "demo.site", "id": 101}
]

Получить сделки по сайту

GET /api/userapi/v1/projects?site_id=100&date_start=2023-01-01&date_end=2023-12-31&page=1

Ответ:

{
  "projects": [
    {"id": 1, "site_id": 100, "date": "2023-03-01"}
  ],
  "last_page": 1,
  "total": 1
}

Используйте фильтры по дате, чтобы загружать данные только за нужный период.

Получить подробности сделки

GET /api/userapi/v1/project/1?site_id=100

Ответ:

{
  "neiros_vizit": "5f1363cc...",
  "phone": "79999999999",
  "traffic": "google",
  "status": "Неразобранное"
}

Вы получаете всю информацию: трафик, канал, телефон, длительность звонка и даже ссылку на запись.

Обновить сумму сделки

POST /api/userapi/v1/project/1/update

Тело запроса:

{
  "site_id": 100,
  "summ": 1500
}

Ответ:

"success": true

Важные замечания

• Все запросы — в формате JSON.
• Не передавайте токен в URL — только в заголовке.
• При ошибке 401 — проверьте токен или повторно авторизуйтесь.
• Запросы можно тестировать напрямую через Swagger-интерфейс на api.neiros.ru.

Вы можете настроить автоматическую синхронизацию данных:

• Подтягивайте заявки в CRM.
• Отправляйте события в Power BI.
• Анализируйте звонки, источники и статусы.

API — это мост между Neiros и вашей IT-инфраструктурой.🚀