Aracılığıyla paylaş

Döviz kurlarını alma

Bu makalede, belirli bir ay için döviz kurlarının nasıl alınacakları açıklanmaktadır.

Önkoşullar

  • API kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca uygulama kullanıcı kimlik doğrulamasını destekler. Yalnızca uygulama ile kullanım henüz desteklenmiyor.
  • Bu API şu anda yalnızca iş ortaklarının şu rollerden birinde olması gereken kullanıcı erişimini destekler: Yönetici Aracısı veya Satış Aracısı.

Ayrıntılar

  • Şu anda Azure planı CSP yerel para birimleri için beklenen ücretleri hesaplamak için fiyat listesi API'siyle birlikte kullanılmaktadır.
  • Döviz kurları, deftere nakledildikleri ay boyunca geçerlidir.
  • Azure planı fiyatlandırması hakkında daha fazla bilgiyi Azure planı fiyatlandırma belgelerinde bulabilirsiniz.
  • Bu yöntem sonuçları dosya akışı olarak döndürür. Dosya akışı, .csv bir dosya veya .csv zip sıkıştırılmış sürümüdür. Sıkıştırılmış dosyaların nasıl isteneceklerine ilişkin ayrıntılar aşağıda verilmiştir.

REST isteği

İstek söz dizimi

Metot İstek URI'si
GET https://api.partner.microsoft.com/v1.0/sales/fxrates(Month='{month}')/$value

Gerekli URI parametreleri

İstediğiniz döviz kurlarının ayını istemek için aşağıdaki yol parametrelerini kullanın.

Adı Tür Zorunlu Açıklama
Month string Yes YYYYMM biçiminde olmalıdır. Belirtilmezse varsayılan olarak geçerli ay kullanılır.

İstek başlıkları

Yukarıdaki üst bilgilere ek olarak, dosyalar bant genişliğini ve indirme sürelerini azaltan sıkıştırılmış olarak alınabilir. Varsayılan olarak dosyalar sıkıştırılamaz. Dosyaların sıkıştırılmış sürümlerini almak için aşağıdaki üst bilgi değerini ekleyebilirsiniz. Sıkıştırılmış belgelerin yalnızca Nisan 2020'den itibaren kullanılabildiğini, Nisan 2020'den önceki tüm isteklerin yalnızca sıkıştırılmamış olarak kullanılabildiğini unutmayın.

Başlık Değer Türü Değer Açıklama
accept-encoding string Söndürmek isteğe bağlı. Atlanan dosya akışı sıkıştırılmıyorsa.

İstek örneği

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 yanıtı

Başarılı olursa, bu yöntem döviz kurlarını dosya akışı olarak döndürür. Dosya akışı, .csv bir dosya veya .csv zip sıkıştırılmış sürümüdür.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . Hata Kodları.

Yanıt örneği

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

İlgili içerik