currencylayer:Jednoduchá, efektivní konverze měn

Každý vývojář, který provozuje web elektronického obchodu, vám řekne, že odpovědnost za správné zacházení s měnou vám prozradí, že to může být velmi stresující úkol. Pokud napíšete chybný nebo nezabezpečený kód, budete stát peníze svého zaměstnavatele nebo uživatele. Další komplikací pro vývojáře může být převod měny, pokud je aplikace určena pro mezinárodní publikum. Poslední věc, kterou vývojáři potřebují, je složité rozhraní API, zejména takové, které jim pomáhá při manipulaci s měnou. Zde přichází na řadu currencylayer: jednoduché, komplexní API pro převod měn pro váš web a nativní aplikace!

Rychlé zásahy

Zde je několik hlavních výhod nabídky currencylayer:

  • Trusted by Disney Pixar, FedEx, Lyft a MetLife
  • Podporuje desítky měn
  • Podporuje konverzi měn bitcoinů
  • Poskytuje použití HTTPS API
  • Hodnota měny se aktualizuje každých 60 sekund
  • Přehledná dokumentace s mnoha ukázkami kódu (cURL, PHP, jQuery atd.)
  • Velmi konkurenceschopné ceny

Pomocí vrstvy měn

currencylayer nabízí bezplatnou registraci s velkorysým přidělením požadavků na testování. Po registraci dostanete klíč API k zahájení vývoje. Vyzbrojeni klíčem API a dokumentací je čas použít koncové body API currencylayer k experimentování s měnami!

Tipy pro všechny požadavky na měnové vrstvy

  • Všechny požadavky musí být požadavky GET
  • access_key parametr, který představuje váš API KEY, je vyžadován pro všechny požadavky
  • Můžete přidat format=1 na jakýkoli požadavek na vyžádání formátu currenclylayer odpověď JSON (pěkné!)
  • Můžete přidat source={code} změnit zdrojovou měnu z USD do libovolného jazyka
  • Můžete přidat currency={currencylist} určete, pro které měny chcete informace
  • currencylayer poskytuje rozsáhlé ukázky kódu ve své dokumentaci

Získání výpisu měn

Dobrým prvním krokem je použití koncového bodu seznamu měn, abyste zjistili, které měny jsou podporovány vrstvou currencylayer:

# The "list" endpoint provides a basic list of supported currencies
curl http://apilayer.net/api/list?access_key=MY_API_KEY&format=1
// Response:
{
   "success":true,
   "terms":"https:\/\/currencylayer.com\/terms",
   "privacy":"https:\/\/currencylayer.com\/privacy",
   "currencies":{
      "AED":"United Arab Emirates Dirham",
      "AFN":"Afghan Afghani",
      "ALL":"Albanian Lek",
      "AMD":"Armenian Dram",
      "ANG":"Netherlands Antillean Guilder",
      "AOA":"Angolan Kwanza",
      "ARS":"Argentine Peso",
      "AUD":"Australian Dollar",
      "BTC":"Bitcoin", // Yay bitcoin!
      // ...
      "USD":"United States Dollar",
      "UYU":"Uruguayan Peso",
      "UZS":"Uzbekistan Som",
      "VEF":"Venezuelan Bol\u00edvar Fuerte",
      "VND":"Vietnamese Dong"
   }
}

currencylayer podporuje vyčerpávající seznam měn a otevře váš mezinárodní dosah! Všimněte si také, že můžete přidat format=1 na adresu URL vašeho požadavku mít

Získání sazeb v reálném čase

Informace o kurzu v reálném čase jsou pravděpodobně nejoblíbenějším využitím služby pro převod měn, jako je Currencylayer, zejména pokud máte co do činění s nestálou měnou, jako je bitcoin. V případě webů elektronického obchodu, jakmile získáte polohu uživatele (prostřednictvím porovnání IP adres nebo uživatelských preferencí), lokalizované weby zobrazí lokalizovanou cenu.

Můžete použít currencies klíč k získání konverze, kterou chcete

# Retrieve the value of USD compared to EUR (the Euro)
# If you don't provide a "currencies" key, all currencies will be returned
curl http://apilayer.net/api/live?format=1&currencies=EUR&access_key=MY_API_KEY
{
  "success":true,
  "terms":"https:\/\/currencylayer.com\/terms",
  "privacy":"https:\/\/currencylayer.com\/privacy",
  "timestamp":1494266647,
  "source":"USD",
  "quotes":{
    "USDEUR":0.914798
  }
}

Hromadné stahování měnových kurzů je chytrý způsob, jak omezit používání API; currencylayer umožňuje vývojářům získat více hodnot měn najednou:

# Retrieve the value of USD compared to EUR (the Euro), GBP (Pound), BTC (Bitcoin)
curl http://apilayer.net/api/live?format=1&currencies=GBP,EUR,BTC&access_key=MY_API_KEY
{
  "success":true,
  "terms":"https:\/\/currencylayer.com\/terms",
  "privacy":"https:\/\/currencylayer.com\/privacy",
  "timestamp":1494266647,
  "source":"USD",
  "quotes":{
    "USDGBP":0.77271, // 1 USD is 0.77271 Pounds (GBP)
    "USDEUR":0.914798,
    "USDBTC":0.000628
  }
}

Pokud nepotřebujete okamžitou přesnost, doporučoval bych ukládat odpovědi z měnové vrstvy do mezipaměti, aby byl váš systém efektivní a jak rychlost, tak využití API. Líbí se mi, že currencylayer umožňuje vývojářům získávat informace hromadně.

Získání historických údajů o měně

Načítání historických dat je také příjemná funkce z currencylayer, zvláště když pracujete s nestálými měnami. Tato funkce je skvělá pro vytváření grafů na základě hodnot měn.

# Get the value of BTC one year ago
curl http://apilayer.net/api/historical?date=2016-05-08¤cies=BTC&format=1&access_key=MY_API_KEY

# Get the value of BTC two years ago
curl http://apilayer.net/api/historical?date=2015-05-08¤cies=BTC&format=1&access_key=MY_API_KEY
// 2016
{
  "success":true,
  "terms":"https:\/\/currencylayer.com\/terms",
  "privacy":"https:\/\/currencylayer.com\/privacy",
  "historical":true,
  "date":"2016-05-08",
  "timestamp":1462751999,
  "source":"USD",
  "quotes":{
    "USDBTC":0.002177
  }
}

// 2015
{
  "success":true,
  "terms":"https:\/\/currencylayer.com\/terms",
  "privacy":"https:\/\/currencylayer.com\/privacy",
  "historical":true,
  "date":"2015-05-08",
  "timestamp":1431129599,
  "source":"USD",
  "quotes":{
    "USDBTC":0.004093
  }
}

Koncový bod historických dat přijímá jediný argument data a vrací hodnotu měny pro každou podporovanou měnu.

Použití JSONP

Jsem velkým fanouškem JSONP; Kolikrát jsem musel zakódovat proxy, abych přenesl CORS, ze mě udělalo naštvaného, ​​cynického vývojáře. currencylayer poskytuje podporu JSONP ještě daleko:

// Get a conversion from USD to GBP for $20
$.ajax({
    url: 'http://apilayer.net/api/convert?access_key=MY_ACCESS_KEY&from=USD&to=GBP&amount=20,   
    dataType: 'jsonp',
    success: function(json) {
        // Update the pricing element with the GBP £ value
        document.querySelector('.price').html('£' + json.result);
    }
});

Děkujeme za poskytnutí podpory JSONP, currencylayer!

Dotazy v časovém rámci

Časové dotazy jsou velmi užitečné pro zjištění změny hodnoty měny s nastaveným datem zahájení a ukončení. Jedním příkladem může být Dalším skvělým příkladem je refundace bitcoinových transakcí; pokud svůj bitcoin zakládáte na USD a bitcoin od původní transakce výrazně vzrostl, budete chtít znát hodnotu BTC v době prodeje a upravit částku BTC vrácenou zákazníkovi.

# Customer wants a refund for a purchase made one month earlier
# In this case we need to figure out how much EUR has changed
curl http://apilayer.net/api/timeframe?start_date=2017-04-01&end_date=2017-05-01¤cies=EUR&format=1&access_key=MY_APK_KEY
{
  "success": true,
  "terms": "https://currencylayer.com/terms",
  "privacy": "https://currencylayer.com/privacy",
  "timeframe": true,
  "start_date": "2010-03-01",
  "end_date": "2010-04-01",
  "source": "USD",
  "quotes": {
    "2010-03-01": {
      "USDEUR": 0.738541
    },
    "2010-03-02": {
      "USDEUR": 0.736145
    },
    [...]
  }
}    

Doporučuji také vyzkoušet tento zdroj Node.js, který obaluje vrstvu měn do vzoru podobného RESTu, a dokonce umožňuje dotazování měn každých x milisekundy!

Vývoj systému nebo aplikace, která přijímá peníze, natož vyžaduje převod měn, může být neuvěřitelně stresující; poslední věc, kterou vývojáři potřebují, je příliš komplikované rozhraní API, aby mohli pracovat s měnou. Rozhraní currencylayer API je jedním z nejsnáze použitelných rozhraní API, se kterými jsem kdy pracoval. Po zhodnocení několika dalších služeb, jako je převod měn, mohu také dodat, že měnová vrstva se zdá být cenově nejpřiměřenější, což je obrovský bonus. Pokud vyvíjíte systémy, které vyžadují převod měn, nebo chcete přidat lokalizované ceny, vyzkoušejte currencylayer. Jednoduché, cenově výhodné a vhodné pro vývojáře!