Ознакомьтесь с информацией, которую важно знать, работая над интеграцией с Телфин.Офисом.

• Hostname API сервера: apiproxy.telphin.ru;
  • Hostname API сервера: apiproxy.telphin.ru; Имеет SRV-запись с информацией о резервном адресе altapi.telphin.ru (?)

    Можно делать запрос на основной домен (apiproxy.telphin.ru) с таймаутом. А в случае таймаута на запрос от основного домена делать запрос на альтернативный домен (altapi.telphin.ru).

    Таким образом теперь, в случае возникновения проблем на сети передачи данных от вашего сервера интеграции до нашего сервера API, вы можете использовать резервный канал для API запросов к АТС Телфин. Данное изменение повысит отказоустойчивость вашей интеграции.

    Важно: в случае получения ответа от основного адреса (apiproxy.telphin.ru) дублировать запрос на резервный адрес (altapi.telphin.ru) не нужно!

    Немного деталей:

    dig altapi.telphin.ru
    altapi.telphin.ru.      302     IN      A       46.229.221.93
     dig apiproxy.telphin.ru naptr
    apiproxy.telphin.ru.    599     IN      NAPTR   10 100 "s" "https+srv" "" _https._tcp.apiproxy.telphin.ru.
     dig _https._tcp.apiproxy.telphin.ru. srv
    _https._tcp.apiproxy.telphin.ru. 541 IN SRV     10 50 443 apiproxy.telphin.ru.
    _https._tcp.apiproxy.telphin.ru. 541 IN SRV     20 50 443 altapi.telphin.ru.

• Hostname http-хранилища: storage.telphin.ru;
• Адрес создания приложения для API: apiproxy.telphin.ru/app/;
• Логин и пароль для создания приложений — это логин и пароль для доступа к интерфейсу виртуальной АТС «Телфин.Офис»;
• extension ID и client ID не имеют ничего общего с SIP ID внутренних номеров и вашим логином и запрашиваются либо определяются соответствующими методами API;
• Ошибки 4XX — это ошибки передаваемого запроса, указание на которые можно увидеть, изучив такие ошибки. Просьба внимательно относиться к ответам сервера API — это ускорит решение Ваших вопросов в случае их возникновения;
• Если на вашем оборудовании настроена фильтрация по ip-адресам, то необходимо разрешить:
  • 213.170.84.96/27
  • 46.229.221.80/28
  • 79.175.9.160/28
  • 81.29.132.240/29
• При обращении в техническую поддержку в целях получения более оперативного ответа на Ваш вопрос рекомендуется делать это только по адресу support@telphin.ru, при этом сразу указывать используемый метод, все передаваемые параметры запроса, а также ответ, полученный на Ваш запрос!

Основной адрес сервера: apiproxy.telphin.ru

Резервный адрес сервера: altapi.telphin.ru

Тестирование интернет канала до API-сервера выполняется обязательно с того же внешнего IP адреса с которого работает интеграция.

Тестирование выполняется следующей командой:

• Для пользователей с операционной системой Linux: mtr -p 443 -T -w домен_из_указанных_ниже
• Для пользователей с операционной системой Windows необходимо скачать утилиту winMTR

Утилиту winMTR обязательно необходимо запускать с правами администратора.

В поле Host необходимо указать домен, нажать кнопку Start и подождать ~1 минуту.

Домены, которые обязательно необходимо проверить:

• apiproxy.telphin.ru
• altapi.telphin.ru

Результат тестирования по каждому домену необходимо экспортировать в HTML файл с помощью кнопки Export HTML, отправить на почту support@telphin.ru с обязательным указанием в теле письма внешнего IP адреса с которого работает интеграция.