02.07.2021

Новые API: идентификаторы документов и статус сервисов НУЦ

Всем привет!

Мы добавили новые API:

• встраивание идентификатора SIGEX в имя файла и извлечение идентификатора SIGEX из имени файла;
• текущая статистика доступности сторонних сервисов.

Для того, чтобы разработчикам информационных систем было проще формировать имена файлов со встроенными идентификаторами SIGEX, мы добавили GET /api/{id}/buildFileName?name=XXX - сформировать имя файла с идентификатором SIGEX. Имена файлов с идентификаторами SIGEX удобны тем, что все наши интерфейсы (https://sigex.kz и SIGEX Desktop for Windows) автоматически умеют извлекать идентификаторы SIGEX из таких имен файлов и отоброжать информацию о подписях под документом.

Обратную операцию можно выполнить с помощью GET /api/idFromFileName/?name=XXX - получить идентификатор SIGEX из имени файла.

Для того, чтобы обеспечить большую прозрачность работы нашего сервиса, мы реализовали API, позволяющий получать информацию о том, были ли у нашего сервиса проблемы со сторонними сервисами: GET /api/externalServicesStats - статистика доступности сторонних сервисов. В данный момент речь идет о сервисах OCSP и TSP НУЦ РК. API позволяет определить пытался ли в последнее время SIGEX связываться с этими сервисами и все ли попытки завершились успешно. Напомним о нескольких инциндентах связанных с доступностью:

• https://forum.pki.gov.kz/t/ocsp-server-ne-rabotaet/514
• https://forum.pki.gov.kz/t/problemy-s-servisom-ocsp-12-i-13-iyunya-2021-goda/789
• https://forum.pki.gov.kz/t/problemy-s-servisom-ocsp-19-iyunya-2021-goda/808

Так же текущая статистика доступна на специальной странице Сторонние сервисы.

Спасибо за внимание!