java.net.http, Jackson и аннотаций nullness JSpecify. У каждого метода есть вариант ...Async, который возвращает CompletableFuture. Что общего у всех серверных SDK, описано в обзоре серверных SDK.
Установка
me.didit:didit-java в Maven Central. Исходный код и журнал изменений находятся в didit-protocol/sdk-java на GitHub.
Настройка клиента
new Didit() читает DIDIT_API_KEY из переменных окружения. Чтобы переопределить его, а также задать идентификаторы организации и приложения, которые нужны вызовам в контексте приложения (кейсы, сети, регуляторные отчёты), используйте builder.
build() проверяет обязательные поля. Необязательные поля ответа представлены значениями Optional. В Kotlin их читают через .getOrNull(). Фрагменты кода на этой странице и на каждой странице справочника API являются телом метода, а нужные импорты указаны над ними.
Создание сессии
Создайте сессию верификации для сценария и отправьте пользователя по её URL.Получение решения
Когда пользователь завершит процесс (или когда придёт webhook), получите решение. Каждый результат функции представляет собой список с одной записью на каждый узел сценария.Проверка webhook
Передайте необработанное тело запроса ровно в том виде, в каком оно получено, и заголовки запроса.Webhooks.verify выбрасывает WebhookVerificationException для любой доставки, которая не является действительной и актуальной, а в остальных случаях возвращает типизированное событие.
@RequestBody byte[] body, а заголовки как @RequestHeader Map<String, String> headers. Чтобы принимать два секрета во время ротации одного из них, передайте VerifyOptions. События и схема подписи описаны на странице Webhooks.
Скрининг транзакции
Отправьте платёж, вывод средств или криптоперевод в мониторинг транзакций. В ответе будут указаны статус и оценка риска.Проверка токенов Authentication
Authentication проверяет токены доступа, которые подписывает ваш издатель Authentication, на вашем бэкенде, без вызова Didit для каждого запроса. Также он обменивает коды, обновляет токены, проверяет и отзывает сессии и выполняет проверки с усиленной аутентификацией.
Проверка токенов выполняет проверки из раздела Проверка токена на вашем сервере с учётом издателя и ключей подписи вашего приложения.
Ошибки
Все исключения являются наследниками непроверяемого исключенияDiditException.