7.4 Стандарт Банка России. Отправка сообщения ФП
Отправка ФП ЭС на ТШ КБР осуществляется посылкой HTTP-запроса (HTTP request) методом POST по протоколу HTTP 1.1 [RFC 2616] на URL https://хост:8888/<суффикс>/post.
Заголовки HTTP-запроса должны содержать следующие обязательные значения:
Authorization
|
Authorization: Basic xxxxxxxxxxxxxxxxxxx, где xxxxxxxxxxxxxxxxxxx - данные ФП.
Данные ФП формируются следующим образом:
а) логин и пароль, разделенные двоеточием, пример: aladdin:opensesame;
б) результирующая строка, закодированная в Base64 (RFC4648) пример: YWxhZGRpbjpvcGVuc2VzYW11.
При отсутствии данного заголовка ТШ КБР посылает HTTP-ответ (HTTP response) с телом служебного сообщения и кодом ответа 401 требования аутентификации
|
Content-type
|
Content-type - идентификатор сообщения ЦР: "application/xml".
Не кодируется в Base64.
|
Connection
|
Connection: keep-alive
|
Тело сообщения содержит XML сообщение - не кодируется в Base64. XML сообщение должно быть оформлено в соответствии с документом [5].
Максимальное время ожидания ответа на запрос ФП составляет 5 секунд с момента направления ФП POST-запроса.
В ответ на запрос ТШ КБР возвращает HTTP-ответ (HTTP response) с пустым телом и кодом ответа:
а) 20X, как факт успешного принятия сообщения:
1) 202 - запрос принят в работу;
б) 30X, перенаправление запроса:
1) 302 - следующий запрос направлять на другой узел, указанный в заголовке ответа в поле Location;
в) 40X - требования к пользовательским действиям:
1) 400 - неправильный формат;
2) 401 - необходима аутентификация;
3) 404 - неправильный запрос;
г) 50X - ошибки системы:
1) 501 - внутренняя ошибка.
Заголовок HTTP-ответа, в случае успешного принятия сообщения содержит следующие значения (но не ограничивается ими):
InstanceID
|
InstanceID - идентификатор, передаваемого сообщения. Используется для идентификации сообщения (формат random UUID). Не кодируется в Base64
|