Поделиться через

Получить курсы обмена иностранных валют

В этой статье объясняется, как получить валютные курсы за данный месяц.

Предварительные условия

  • Учетные данные, как описано в аутентификации API. Этот сценарий поддерживает только проверку подлинности пользователей приложений. Функция "только для приложений" пока не поддерживается.
  • Этот API в настоящее время поддерживает только доступ пользователей, где партнеры должны находиться в одной из следующих ролей: агент администрирования или агент продаж.

Сведения

  • В настоящее время используется с API получения прайс-листа для вычисления ожидаемых расходов для локальных валют CSP плана Azure.
  • Валютные курсы остаются актуальными в течение всего месяца, в который они публикуются.
  • Дополнительные сведения о ценах на план Azure см. в документации по ценам на план Azure.
  • Этот метод возвращает результаты в виде потока файлов. Поток файлов — это файл .csv или сжатый zip-файл .csv. Ниже приведены сведения о том, как запрашивать сжатые файлы.

Запрос REST

Синтаксис запроса

Способ URI запроса
GET https://api.partner.microsoft.com/v1.0/sales/fxrates(Month='{month}')/$value

Обязательные параметры URI

Используйте следующие параметры пути, чтобы запросить нужный месяц валютных курсов.

Имя. Тип Обязательно Описание
месяц строка Да Должен быть в формате YYYYMM. Если пропущено, используется текущий месяц по умолчанию.

Заголовки запросов

В дополнение к приведенным выше заголовкам файлы можно получить в сжатом виде, что сокращает пропускную способность и время загрузки. По умолчанию файлы не сжимаются. Чтобы получить сжатые версии файлов, можно включить следующее значение заголовка. Осознайте, что сжатые листы доступны только с апреля 2020 года, все запросы до апреля 2020 года доступны только как не сжатые.

Заголовок Тип значения значение Описание
Accept-Encoding строка сдуть Необязательно. Если опущенный поток файлов не сжимается.

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

GET https://api.partner.microsoft.com/v1.0/sales/fxrates(Month='201909')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

Ответ REST

В случае успешного выполнения этот метод возвращает валютные курсы в виде файлового потока. Поток файлов — это файл .csv или сжатый zip-файл .csv.

Коды успеха и ошибок ответа

Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. См. полный список кодов ошибок.

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

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 18548
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=fxrates
Request-ID: 65fb6e59-051b-42f7-8771-c8c139b3c901
Date: Wed, 02 Oct 2019 03:42:54 GMT

"CurrencyCode","USDPerUnit","Month"
"AED","0.27224589249009701","2019”
======= Truncated ==============

Связанный контент