Аутентификация и безопасность
1. При использовании первой версии API аутентификация будет происходить посредством пересылки специально сгенерированного секретного ключа: User_token. Во второй и третьей версиях API этот ключ имеет название agent_token.
2. При использовании второй и третьей версий API дополнительным уровнем безопасности является проверка ip-адресов с которых приходят запросы. Запросы с определенным ключом агента будут разрешены только для определенных статических ip-адресов. Список ip-адресов необходимо предоставить команде Call-tracking.by заблаговременно.
3. Также при использовании второй и третьей версий API после получения запроса на использование API, персональным менеджером будет сгенерирован уникальный UUID пользователя для использования API. UUID пользователя должен передаваться в каждом запросе в параметре user_uuid.
Запросы к API и обработка исключительных ситуаций
1. API версий 2 и 3 обрабатывают исключительные ситуации и отвечают с указанием кодов ошибок.
2. Есть некоторые различия в методах, доступных в разных версиях API. Далее будут перечислены возможности каждой из версий:
API v1
- Получение групп компаний;
- Получение информации об активных кампаниях пользователя;
- Получение информации о звонках по кампаниям пользователя;
- Получение информации о всех звонках пользователя;
API v2
- Получение групп компаний;
- Получение информации об активных кампаниях пользователя;
- Получение информации о звонках по кампаниям пользователя;
- Получение информации о всех звонках пользователя;
- Получение данных о звонках, совершенных с определенного номера;
API v3
- Получение групп компаний;
- Получение информации об активных кампаниях пользователя;
- Получение информации о звонках по кампаниям пользователя;
- Получение информации о всех звонках пользователя;
- Запросы на создание пользователя;