获取外币汇率

2024-10-15

本文介绍如何获取给定月份的外汇汇率。

先决条件

API 身份验证中所述的凭据。此方案仅支持应用程序用户身份验证。尚不支持仅应用程序。
此 API 目前仅支持合作伙伴必须处于以下角色之一的用户访问权限：管理员代理或销售代理。

详细信息

当前用于获取价目表 API 来计算 Azure 计划 CSP 本地货币的预期费用。
外汇汇率在发布整个月份均属实。
有关 Azure 计划定价的详细信息，请参阅 Azure 计划定价文档。
此方法将结果作为文件流返回。文件流是.csv文件或 zip 压缩版本的.csv。下面提供了有关如何请求压缩文件的详细信息。

REST 请求

请求语法

方法	请求 URI
GET	`https://api.partner.microsoft.com/v1.0/sales/fxrates(Month='{month}')/$value`

URI 所需的参数

使用以下路径参数请求所需汇率月份。

名称	类型	必需	说明
Month	string	是	必须采用 YYYYMM 格式。如果省略默认为当前月份。

请求标头

有关详细信息，请参阅 Partner REST headers（合作伙伴 REST 标头）。

除了上述标头外，还可以将文件检索为压缩的带宽和下载时间。默认情况下，不会压缩文件。若要获取文件的压缩版本，可以包括以下标头值。意识到压缩工作表仅在 2020 年 4 月起可用，2020 年 4 月之前的所有请求仅可用，因为未压缩。

头文件	值类型	值	说明
Accept-Encoding	string	deflate	可选。如果未压缩省略的文件流。

请求示例

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 ==============

获取价目表