Прежде чем обращаться к нам за помощью по интеграции с API Литера5, пожалуйста, выполните эту инструкцию
- Убедитесь, что взяли самые свежие исходники клиента здесь: https://github.com/orfogrammatika/litera5-api-php-client.
- Подставьте в файл
examples/_litera5_api_config.php
свои идентификаторы/секретные ключи. - Запустите локально скрипт
php examples/api_setup.php
. Если работает — переходим к п. 6. - Если не работает, запустите скрипт
php examples/api_diagnose.php > diagnose.txt
. - Внимательно изучите результаты диагностики: получилось ли добыть IP адреса, проходят ли пинги/трейсы, получилось ли добыть с нашего сервера версию API?
- если у вас возникли сложности с интерпретацией результатов диагностики, отправляйте этот файл к нам в поддержку, возможно, мы сможем чем-то помочь.
- Если локально всё заработало, начинаем подключать это же дело на боевом сервере. Порядок действий такой же, как и локально.
- Если не завелось, то так же запустите диагностику. Получите два файла с диагностикой (локальную, где работает, и серверную, где не работает) и очень внимательно изучите — в чём различия?
- На сервере обязательно проверьте настройки файерволов, они должны пускать на наши айпишники, а лучше периодически DNS-сервер опрашивать на предмет: не изменилось ли у нас чего в этом вопросе?
- Если диагностика отрабатывает, там всё нормально и вы получаете ответ от нашего сервера API, но с запросами происходит что-то странное
- включите логирование API (новые константы в файле
examples/_litera5_api_config.php
API_DEBUG_LOG
иAPI_DEBUG_FILE
) и внимательно изучите логи. - Если самостоятельное изучение результатов диагностики/логов запросов/ответов не помогает, тогда пишите нам, в службу поддержки.
- При обращении в нашу службу поддержки обязательно прикладывайте:
- файл с результатами диагностики;
- файл с нашими логами вызовов API;
- если хочется написать что-нибудь вроде «запускаю ваши скрипты», то указывайте какой конкретно наш скрипт запускается;
- если в «наш скрипт» вносились любые изменения, то прилагайте изменённый скрипт к запросу на помощь.