3.10. /api/v2/get-exchange

Введение

Получение обменного курса инициируется запросом HTTPS POST с использованием указанных ниже URL и параметров. Для аутентификации используйте OAuth HMAC-SHA1. См. статусы.

API URL

Примечание

Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.

Интеграционная среда

Производственная среда

https://sandbox.sbctech.ru/paynet/api/v2/get-exchange/ENDPOINTID

https://gate.sbctech.ru/paynet/api/v2/get-exchange/ENDPOINTID

Параметры запроса

Примечание

Запрос должен иметь content-type=application/x-www-form-urlencoded и заголовки авторизации.

Название параметра

Описание

Значение

exchange-provider

Описание: Exchange provider.
Необходимость: Обязательно
Тип: String
Длина: 128

exchange-currency-code-from

Код валюты, которую необходимо обменять (см.: Коды валют).
Необходимость: Обязательно
Тип: String
Длина: 128

exchange-currency-code-to

Код валюты, который необходимо получить (см.: Коды валют).
Необходимость: Обязательно
Тип: String
Длина: 128

Параметры ответа

Примечание

Ответ имеет заголовок Content-Type: text/html;charset=utf-8. Все поля имеют кодировку x-www-form-urlencoded, с символом (0xA) в конце значения каждого параметра.

Название параметра

Описание

exchange-low-rate

Описание: Provider’s buy rate.

exchange-high-rate

Описание: Provider’s sell rate.

Пример запроса

POST /paynet/api/v2/get-exchange/39790 HTTP/1.1
Host: sandbox.sbctech.ru
User-Agent: curl/7.83.0
Accept: */*
Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="test_merch",oauth_timestamp="1684995901",oauth_nonce="1kKy3hMlAe1",oauth_signature_method="HMAC-SHA1",oauth_signature="jGUaNFqLvBO1gGgWag%2FSU3wMnUc%3D"
Content-Length: 222
Content-Type: application/x-www-form-urlencoded
Connection: close

exchange-currency-code-from=USD
&exchange-currency-code-to=RUB
&exchange-provider=test
&oauth_consumer_key=test_merch
&oauth_nonce=1kKy3hMlAe1
&oauth_signature_method=HMAC-SHA1
&oauth_timestamp=1684995901
&oauth_version=1.0

Пример успешного ответа

HTTP/1.1 200
Server: server
Date: Thu, 25 May 2023 06:27:46 GMT
Content-Length: 48
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Strict-Transport-Security: max-age=31536000

exchange-low-rate=10.00
&exchange-high-rate=20.00

Пример неуспешного ответа

HTTP/1.1 403
Server: server
Date: Thu, 25 May 2023 07:02:59 GMT
Content-Type: text/html
Content-Length: 735
Connection: close
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000

error-message=Book TCurrencyBook was not found by code USB

Коллекция Postman

Конструктор запросов

HTTP method
URL
parameters
version
consumer key
consumer secret
timestamp

nonce

signature method

normalized parameters
signature base string
signature
authorization header