Minhas tarefas mais estressantes como programador sempre giraram em torno de dinheiro. Quer esteja codificando um site para um cliente, sua própria empresa ou seu empregador, o senhor quer ter certeza de que qualquer manuseio de moeda é preciso, seguro e localizado. Sempre queremos que nosso código funcione, mas quando o sustento ou o emprego de alguém está em jogo, percebe-se outro nível de importância.


Depois de usar o fixer.ioO fixer.io fornece conversão de moedas e taxas de câmbio para o tempo presente e histórico, garantindo dados precisos no checkout, bem como reembolsos no caso de a moeda ter mudado ao longo do tempo.


Resultados rápidos

  • O fixer.io permite que o senhor registrar-se gratuitamente
  • O fixer.io tem a confiança da Microsoft, Kraken, Samsung e instacart
  • O fixer.io é uma API simples e fácil de usar
  • O fixer.io fornece dados precisos sobre moedas atuais e históricas
  • O fixer.io também fornece informações sobre Bitcoin (BTC)
  • O fixer.io é da apilayer, o mesmo provedor de serviços do currencylayer, eversigne streetlayer

Usando fixer.io


O fixer.io é outra aula magistral da apilayer sobre a criação de uma API que é fácil de usar e muito focada. A chamada de API mais fácil é a seguinte:



# Get currency rate based on EUR
curl http://data.fixer.io/api/latest?access_key=API_KEY&base=EUR



{  
   "success":true,
   "timestamp":1521677363,
   "base":"EUR",
   "date":"2018-03-22",
   "rates":{  
      "AED":4.538449,
      "AFN":85.146208,
      // ...
      "BTC":0.000139,
      // ...
      "USD":1.235794
   }
}


Com essa chamada, o senhor obterá conversões de moeda com uma determinada moeda base, nesse caso, o dólar americano.


Agora considere o caso de um reembolso, especialmente um reembolso para uma moeda como o Bitcoin, que flutua rapidamente. Se a moeda aumentar drasticamente, é possível que os clientes queiram solicitar um reembolso simplesmente devido à mudança de valor. O senhor pode proteger a si mesmo ou a seu cliente usando a função de reembolso do fixer.io. state_date e end_date para obter uma alteração no valor da moeda em uma determinada data:



curl http://data.fixer.io/api/timeseries
    ? access_key = API_KEY
    & start_date = 2012-05-01
    & end_date = 2012-05-25



{
    "success": true,
    "timeseries": true,
    "start_date": "2012-05-01",
    "end_date": "2012-05-03",
    "base": "EUR",
    "rates": {
        "2012-05-01":{
          "USD": 1.322891,
          "AUD": 1.278047,
          "CAD": 1.302303
        },
        "2012-05-02": {
          "USD": 1.315066,
          "AUD": 1.274202,
          "CAD": 1.299083
        },
        "2012-05-03": {
          "USD": 1.314491,
          "AUD": 1.280135,
          "CAD": 1.296868
        },
        [...]
    }
}


A recuperação desse valor permite que o senhor faça o reembolso para a moeda fiduciária fornecida sem perder o valor com base no tempo da transação!


A apilayer sempre permite que o usuário use JSONP com suas APIs, e o fixer.io não é exceção:



// set endpoint and your access key
endpoint="latest"
access_key = 'API_KEY';

// get the most recent exchange rates via the "latest" endpoint:
$.ajax({
    url: 'http://data.fixer.io/api/' + endpoint + '?access_key=' + access_key,   
    dataType: 'jsonp',
    success: function(json) {

        // exchange rata data is stored in json.rates
        alert(json.rates.GBP);
        
        // base currency is stored in json.base
        alert(json.base);
        
        // timestamp can be accessed in json.timestamp
        alert(json.timestamp);
        
    }
});


Muitas APIs não oferecem suporte a JSONP, fazendo com que o senhor crie seus próprios proxies – felizmente não é o caso do fixer.io!


Conclusão


fixer.io é exatamente o que uma API deve ser: fácil de usar, sem complicações e confiável; gosto de usar e analisar as APIs da apilayer exatamente por esse motivo. Quando os dados forem realmente importantes, especialmente no caso de dinheiro, use uma API em que o senhor possa confiar: fixer.io!