Если что-то не получается. Инструкция

Если что-то не выходит...

Прежде чем обращаться к нам за помощью по интеграции с API Литера5, пожалуйста, выполните эту инструкцию

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