No cenário financeiro acelerado de hoje, empresas e desenvolvedores frequentemente enfrentam desafios ao acessar dados financeiros confiáveis e precisos. Seja para conversão de moeda, cálculos de investimento ou acompanhamento de taxas de juros, ter as ferramentas certas pode fazer toda a diferença. Migrar do ProgrammableWeb para o Zyla Hub pode simplificar esse processo, oferecendo uma plataforma unificada para várias APIs financeiras. Este guia irá orientá-lo pelo processo de migração, focando nas principais APIs disponíveis na categoria financeira, incluindo a API de Câmbio, API Forex, API de Moeda Internacional, API de Cálculos de Investimento, API de Taxas de Juros Atuais, API de Conversor Forex, API Fast Forex e API de Calculadora de Juros. Cobriremos a configuração da conta, mudanças de autenticação, compatibilidade de SDK, mapeamento de endpoints e armadilhas comuns a evitar, garantindo uma transição tranquila.
Por que Migrar para o Zyla Hub?
O Zyla Hub simplifica a integração e gestão de APIs, fornecendo uma plataforma unificada onde os desenvolvedores podem acessar várias APIs com uma única conta. Isso significa menos tempo gasto na gestão de diferentes contas e mais tempo focando na construção de aplicações. O Zyla Hub oferece um único SDK para múltiplas integrações de API, análises consolidadas e monitoramento em todas as APIs, garantindo confiabilidade e tempo de atividade. Com documentação abrangente e formatos de resposta consistentes, os desenvolvedores podem aprimorar sua experiência e otimizar seus fluxos de trabalho.
Processo de Migração Passo a Passo
1. Configuração da Conta
Para iniciar sua migração, crie uma conta na plataforma Zyla Hub. Isso lhe dará acesso a todas as APIs disponíveis na categoria financeira. Uma vez que sua conta esteja configurada, você pode explorar as várias APIs e suas funcionalidades.
2. Mudanças de Autenticação
Diferente do ProgrammableWeb, o Zyla Hub utiliza um método de autenticação unificado em todas as APIs. Isso significa que você precisará atualizar sua aplicação para usar os novos tokens de autenticação fornecidos pelo Zyla Hub. Certifique-se de que sua aplicação esteja configurada para lidar com esses tokens de forma segura.
3. Compatibilidade de SDK
O Zyla Hub fornece um único SDK que suporta todas as APIs na categoria financeira. Este SDK simplifica o processo de integração, permitindo que você faça chamadas de API sem se preocupar com as complexidades subjacentes. Certifique-se de atualizar sua aplicação para usar o SDK do Zyla para compatibilidade sem interrupções.
4. Mapeamento de Endpoints
Mapear suas chamadas de API existentes para os endpoints do Zyla Hub é crucial para uma transição suave. Abaixo, discutiremos as principais APIs disponíveis na categoria financeira, suas funcionalidades e como implementá-las de forma eficaz.
APIs Principais na Categoria Financeira
API de Câmbio
A API de Câmbio permite que os desenvolvedores acessem dados e serviços de câmbio, possibilitando a integração de taxas de câmbio em tempo real ou históricas e capacidades de conversão de moeda em aplicações. Esta API é essencial para empresas, instituições financeiras e empresas de fintech que requerem dados de câmbio precisos e atualizados.
Principais Funcionalidades e Capacidades
Uma das principais funcionalidades da API de Câmbio é fornecer taxas de câmbio em tempo real. Os desenvolvedores podem acessar as últimas taxas de câmbio para vários pares de moedas, como EUR/USD, GBP/JPY ou AUD/CAD. Este recurso é valioso para aplicações que requerem conversão de moeda precisa, como plataformas de e-commerce e ferramentas de relatórios financeiros.
Obter Conversão
Para usar este endpoint, você deve especificar as moedas que deseja converter e o valor. Um parâmetro opcional permite que você recupere informações de acordo com uma data específica.
O parâmetro de data deve ser escrito no formato ISO: YYYY-MM-DDTHH:mm:ss.sssZ.
As moedas suportadas incluem: IDR, ILS, INR, KRW, MXN, MYR, NZD, PHP, SGD, THB, ZAR, EUR, USD, JPY, BGN, CZK, DKK, GBP, HUF, PLN, RON, SEK, CHF, ISK, NOK, TRY, AUD, BRL, CAD, CNY, HKD.
{"success":true,"result":{"date":"2023-05-04T19:48:02.114Z","from":{"currency":"EUR","amount":20},"to":{"currency":"USD","amount":22.148}}}
Este recurso permite que as empresas automatizem processos de câmbio de moeda, aprimorando a experiência do usuário e a eficiência operacional.
Perguntas Frequentes
Q: Como os usuários podem personalizar suas solicitações de dados?
A: Os usuários podem personalizar suas solicitações especificando as moedas de origem e destino, o valor a ser convertido e, opcionalmente, uma data específica para dados históricos.
Q: Quais são os casos de uso típicos para esses dados?
A: Casos de uso típicos incluem plataformas de e-commerce que precisam de conversão de moeda em tempo real para transações, ferramentas de relatórios financeiros que calculam taxas de câmbio precisas e plataformas de negociação de moeda que analisam tendências de mercado.
API Forex
A API Forex fornece acesso a taxas de câmbio em tempo real para mais de 190 moedas. Ela oferece atualizações instantâneas e latência mínima, tornando-se uma solução econômica para conversões de moeda precisas.
Principais Funcionalidades e Capacidades
A API Forex serve como um hub centralizado para recuperar dados de taxas de câmbio em tempo real. Os usuários podem acessar informações vitais, como taxas de câmbio, fatores de conversão e dados históricos, simplesmente inserindo pares de moedas e moedas base.
Moedas Disponíveis
Para usar este endpoint, basta executá-lo para obter as moedas disponíveis.
{"AED":"Dirham dos Emirados Árabes Unidos","AFN":"Afeganistão Afegão","ALL":"Lek Albanês","AMD":"Dram Armênio","ANG":"Gulden das Antilhas Holandesas","AOA":"Kwanza Angolano","ARS":"Peso Argentino","AUD":"Dólar Australiano","AWG":"Florim Arubano","AZN":"Manat Azerbaijano","BAM":"Marco Conversível da Bósnia e Herzegovina","BBD":"Dólar Barbadian","BDT":"Taka Bangladense","BGN":"Lev Búlgaro","BHD":"Dinar Bahreinita","BIF":"Franco Burundense","BMD":"Dólar Bermudense","BND":"Dólar de Brunei","BOB":"Boliviano Boliviano","BRL":"Real Brasileiro","BSD":"Dólar Bahamense","BTN":"Ngultrum Bhutanês","BWP":"Pula de Botswana","BYN":"Rublo Bielorrusso","BYR":"Rublo Bielorrusso","BZD":"Dólar de Belize","CAD":"Dólar Canadense","CDF":"Franco Congolês","CHF":"Franco Suíço","CLF":"Unidad de Fomento","CLP":"Peso Chileno","CNH":"Yuan Renminbi Chinês Offshore","CNY":"Yuan Renminbi Chinês","COP":"Peso Colombiano","CRC":"Colón Costarriquenho","CUC":"Peso Cubano Conversível","CVE":"Escudo de Cabo Verde","CZK":"Coroa Checa","DJF":"Franco Djibutiano","DKK":"Coroa Dinamarquesa","DOP":"Peso Dominicano","DZD":"Dinar Argelino","EGP":"Libra Egípcia","ERN":"Nakfa Eritreia","ETB":"Birr Etíope","EUR":"Euro","FJD":"Dólar Fijiano","FKP":"Libra das Ilhas Falkland","GBP":"Libra Esterlina Britânica","GEL":"Lari Georgiano","GGP":"Libra de Guernsey","GHS":"Cedi Ganense","GIP":"Libra de Gibraltar","GMD":"Dalasi Gambiano","GNF":"Franco Guineense","GTQ":"Quetzal Guatemalteco","GYD":"Dólar Guianense","HKD":"Dólar de Hong Kong","HNL":"Lempira Hondurenha","HRK":"Coroa Croata","HTG":"Gourde Haitiano","HUF":"Forint Húngaro","IDR":"Rupia Indonésia","ILS":"Novo Shekel Israelense","IMP":"Libra da Ilha de Man","INR":"Rúpia Indiana","IQD":"Dinar Iraquiano","IRR":"Rial Iraniano","ISK":"Coroa Islandesa","JEP":"Libra de Jersey","JMD":"Dólar Jamaicano","JOD":"Dinar Jordaniano","JPY":"Iene Japonês","KES":"Xelim Queniano","KGS":"Som Quirguiz","KHR":"Riel Cambojano","KMF":"Franco Comoriano","KPW":"Won Norte-Coreano","KRW":"Won Sul-Coreano","KWD":"Dinar Kuwaitiano","KYD":"Dólar das Ilhas Cayman","KZT":"Tenge Cazaque","LAK":"Kip Lao","LBP":"Libra Libanesa","LKR":"Rúpia do Sri Lanka","LRD":"Dólar Liberiano","LSL":"Loti de Lesoto","LYD":"Dinar Líbio","MAD":"Dirham Marroquino","MDL":"Leu Moldavo","MGA":"Ariary Malgaxe","MKD":"Dinar Macedônio","MMK":"Kyat Birmanês","MNT":"Tugrik Mongol","MOP":"Pataca Macaense","MRU":"Ouguiya Mauritano","MUR":"Rúpia Mauriciana","MVR":"Rufiyaa Maldiva","MWK":"Kwacha Malawiano","MXN":"Peso Mexicano","MYR":"Ringgit Malaio","MZN":"Metical Moçambicano","NAD":"Dólar Namibiano","NGN":"Naira Nigeriana","NIO":"Córdoba Nicaraguense","NOK":"Coroa Norueguesa","NPR":"Rúpia Nepalense","NZD":"Dólar Neozelandês","OMR":"Rial Omanense","PAB":"Balboa Panamenho","PEN":"Sol Peruano","PGK":"Kina da Papua Nova Guiné","PHP":"Peso Filipino","PKR":"Rúpia Paquistanesa","PLN":"Zloty Polonês","PYG":"Guarani Paraguaio","QAR":"Rial Qatarense","RON":"Leu Romeno","RSD":"Dinar Sérvio","RUB":"Rublo Russo","RWF":"Franco Ruandense","SAR":"Riyal Saudita","SBD":"Dólar das Ilhas Salomão","SCR":"Rúpia Seychelles","SDG":"Libra Sudanesa","SEK":"Coroa Sueca","SGD":"Dólar de Singapura","SHP":"Libra de Santa Helena","SLL":"Leone de Serra Leoa","SOS":"Xelim Somali","SRD":"Dólar Surinamês","SSP":"Libra do Sudão do Sul","STN":"Dobra de São Tomé e Príncipe","SYP":"Libra Síria","SZL":"Lilangeni Suázi","THB":"Baht Tailandês","TJS":"Somoni Tajique","TMT":"Manat Turcomeno","TND":"Dinar Tunisiano","TOP":"Paanga Tongan","TRY":"Lira Turca","TTD":"Dólar de Trinidad e Tobago","TWD":"Novo Dólar de Taiwan","TZS":"Xelim Tanzaniano","UAH":"Hryvnia Ucraniana","UGX":"Xelim Ugandense","USD":"Dólar dos Estados Unidos","UYU":"Peso Uruguaio","UZS":"Som Uzbeque","VES":"Bolívar Venezuelano","VND":"Dong Vietnamita","VUV":"Vatu de Vanuatu","WST":"Tala Samoano","XAF":"Franco CFA da África Central","XAG":"Onça de Prata","XAU":"Onça de Ouro","XCD":"Dólar do Caribe Oriental","XDR":"Direitos Especiais de Saque","XOF":"Franco CFA da África Ocidental","XPF":"Franco CFP","YER":"Rial Yemenita","ZAR":"Rand Sul-Africano","ZMW":"Kwacha Zambiano","ZWL":"Dólar Zimbabuense"}
Este recurso é particularmente útil para aplicações que requerem conversão de moeda em tempo real, como sites de reservas de viagens e ferramentas de orçamento.
Obter Taxas Mais Recentes
Para usar este endpoint, basta executá-lo para obter as taxas baseadas em USD atualizadas a cada 10 minutos.
{"bs":"USD","ts":1692112793,"rt":{"AED":3.673029999509945,"AFN":84.30969549999942,"ALL":95.67440390970364,"AMD":387.1775,"ANG":1.7961954819490071,"AOA":824.9990000000176,"ARS":350.0315216058202,"AWG":1.7999999999999998,"AZN":1.7,"BAM":1.7890169999999999,"BBD":2,"BDT":109.4613685,"BGN":1.789309995473115,"BHD":0.376868,"BIF":2836.021239499852,"BMD":1,"BND":1.3566394706626188,"BOB":6.922026333333333,"BRL":4.9776,"BSD":1,"BTN":83.310197,"BWP":13.620178999999997,"BYN":2.5243510000000002,"BYR":25243.500000003172,"BZD":2.016561798149524,"CAD":1.3480846348823752,"CDF":2465.5317923967455,"CHF":0.8769226666666667,"CLF":0.0311738,"CLP":861.6399999999812,"CNY":7.281384999007741,"COP":4085.0070058525243,"CRC":535.2535543333333,"CUC":1,"CVE":100.8612913632844,"CZK":22.04439679918709,"DJF":177.88872449999877,"DKK":6.815615462127442,"DOP":56.71551707211867,"DZD":135.8074325196597,"EGP":30.900249999999954,"ETB":55.17795,"EUR":0.9146957767426027,"FJD":2.25772,"FKP":0.7844559933265874,"GBP":0.7844559933265874,"GEL":2.657,"GGP":0.7844559933265874,"GHS":12.0,"GIP":0.7844559933265874,"GMD":60.0,"GNF":9000.0,"GTQ":7.75,"GYD":210.0,"HKD":7.85,"HNL":24.0,"HRK":6.5,"HTG":100.0,"HUF":300.0,"IDR":15000.0,"ILS":3.5,"IMP":0.7844559933265874,"INR":75.0,"IQD":1450.0,"IRR":42000.0,"ISK":130.0,"JEP":0.7844559933265874,"JMD":150.0,"JOD":0.71,"JPY":110.0,"KES":110.0,"KGS":85.0,"KHR":4100.0,"KMF":440.0,"KPW":900.0,"KRW":1200.0,"KWD":0.3,"KYD":0.85,"KZT":420.0,"LAK":9000.0,"LBP":1500.0,"LKR":200.0,"LRD":150.0,"LSL":15.0,"LYD":4.5,"MAD":9.0,"MDL":17.0,"MGA":4000.0,"MKD":50.0,"MMK":1800.0,"MNT":2800.0,"MOP":8.0,"MRU":35.0,"MUR":40.0,"MVR":15.0,"MWK":800.0,"MXN":20.0,"MYR":4.0,"MZN":60.0,"NAD":15.0,"NGN":400.0,"NIO":35.0,"NOK":8.5,"NPR":120.0,"NZD":1.5,"OMR":0.38,"PAB":1.0,"PEN":3.5,"PGK":3.5,"PHP":50.0,"PKR":150.0,"PLN":4.0,"PYG":7000.0,"QAR":3.65,"RON":4.0,"RSD":100.0,"RUB":75.0,"RWF":1000.0,"SAR":3.75,"SBD":8.0,"SCR":15.0,"SDG":300.0,"SEK":8.5,"SGD":1.35,"SHP":0.7844559933265874,"SLL":10000.0,"SOS":600.0,"SRD":7.0,"SSP":150.0,"STN":25.0,"SYP":2500.0,"SZL":15.0,"THB":30.0,"TJS":10.0,"TMT":3.5,"TND":3.0,"TOP":2.25,"TRY":8.0,"TTD":6.5,"TWD":28.0,"TZS":2300.0,"UAH":27.0,"UGX":3600.0,"USD":1.0,"UYU":40.0,"UZS":10000.0,"VES":3000.0,"VND":23000.0,"VUV":110.0,"WST":2.5,"XAF":600.0,"XAG":0.05,"XAU":0.001,"XCD":2.7,"XDR":0.7,"XOF":600.0,"XPF":100.0,"YER":250.0,"ZAR":15.0,"ZMW":20.0,"ZWL":300.0}}
Este recurso é crucial para aplicações que requerem taxas de câmbio atualizadas para análise financeira e relatórios.
Obter Taxa Mais Recente
Para usar este endpoint, você deve indicar duas moedas nos parâmetros para retornar a taxa de câmbio atualizada a cada 10 minutos.
{"ts":1692113393,"rt":1.092629}
Este recurso permite que as empresas acompanhem as taxas de câmbio em tempo real, possibilitando uma melhor tomada de decisão para transações internacionais.
Conversão de Moeda
Para usar este endpoint, você deve indicar duas moedas junto com um valor. As moedas são atualizadas a cada 10 minutos.
{"ts":1692113393,"vl":10.926292}
Este recurso é essencial para aplicações que requerem conversão instantânea de moeda, como plataformas de reservas de viagens e sites de e-commerce.
API de Moeda Internacional
A API de Moeda Internacional simplifica transações transfronteiriças ao oferecer cálculos de taxas de câmbio em tempo real e precisos para conversões globais de moeda sem interrupções.
Obter Conversão
Para usar este endpoint, você deve indicar duas moedas para converter junto com um valor.
{"success":true,"code":0,"timestamp":1690300800,"q":{"from":"USD","to":["CHF"],"amount":1},"result":{"CHF":0.86442}}
Este recurso é valioso para empresas envolvidas em comércio internacional, permitindo que forneçam preços precisos em várias moedas.
Perguntas Frequentes
Q: Como a precisão dos dados é mantida?
A: A precisão dos dados é mantida através de atualizações regulares de fontes financeiras confiáveis, garantindo que a API recupere continuamente as taxas de câmbio mais recentes.
Q: Quais parâmetros podem ser usados com o endpoint Obter Conversão?
A: O endpoint Obter Conversão aceita parâmetros para "from" (moeda de origem), "to" (moeda de destino) e "amount" (valor a ser convertido).
API de Cálculos de Investimento
A API de Cálculos de Investimento é uma solução de software financeiro de ponta que oferece uma ampla gama de cálculos relacionados ao desempenho de investimentos e otimização de portfólio.
Obter Calcular
Para usar este endpoint, você precisa indicar o valor principal, taxa de retorno, período de tempo, frequência de capitalização e detalhes de conversão de moeda.
{"apy":"5.61%","cg_tax":"1.04","compound_interest":"203.11","compounding_freq":"quarterly","investment_returns":"3820.73","principal":"$4000","principal_in":"USD","rate":"5.50%","results_in":"EUR","roi":"5.08","simple_interest":"198.97","time_months":"12 M","time_years":"1.00 Y"}
Este recurso permite que os investidores avaliem o desempenho histórico de seus investimentos, ajudando-os a tomar decisões informadas sobre seus portfólios.
Obter Calcula
Para usar este endpoint, você deve especificar o valor principal, taxa de retorno, período de tempo e frequência de capitalização. A moeda padrão é USD.
{"apy":"6.50%","cg_tax":"$64.75","compound_interest":"$4158.99","compounding_freq":"yearly","investment_returns":"$24158.99","principal":"$20000","principal_in":"USD","rate":"6.50%","results_in":"USD","roi":"$20.79","simple_interest":"$3900.00","time_months":"36 M","time_years":"3.00 Y"}
Este recurso é crucial para aplicações de planejamento financeiro, permitindo que os usuários analisem o desempenho de investimentos e comparem diferentes cenários.
A API de Taxas de Juros Atuais
A API de Taxas de Juros Atuais permite que desenvolvedores e profissionais financeiros acessem informações de taxas de juros em tempo real de bancos centrais e benchmarks ao redor do mundo.
Obter Taxa de Juros
Para usar este endpoint, basta executá-lo para obter as informações sobre a taxa de juros.
{"central_bank_rates":[{"central_bank":"Banco Central Australiano","country":"Austrália","rate_pct":4.35,"last_updated":"11-08-2023"},{"central_bank":"Banco Central Britânico","country":"Reino Unido","rate_pct":4.75,"last_updated":"11-07-2024"},{"central_bank":"Banco Central Chileno","country":"Chile","rate_pct":5.0,"last_updated":"12-17-2024"},{"central_bank":"Banco Central Chinês","country":"China","rate_pct":3.1,"last_updated":"10-21-2024"},{"central_bank":"Banco Central Checo","country":"República Checa","rate_pct":4.0,"last_updated":"11-07-2024"},{"central_bank":"Banco Central Dinamarquês","country":"Dinamarca","rate_pct":2.75,"last_updated":"12-12-2024"},{"central_bank":"Banco Central Japonês","country":"Japão","rate_pct":0.25,"last_updated":"07-31-2024"},{"central_bank":"Banco Central Mexicano","country":"México","rate_pct":10.0,"last_updated":"12-19-2024"},{"central_bank":"Banco Central da Nova Zelândia","country":"Nova Zelândia","rate_pct":5.5,"last_updated":"11-08-2024\