Acesso à API
Requerimentos do Acesso:
|
Parâmetro
|
Detalhes
|
Descrição
|
|---|---|---|
|
appId
|
requerido
string |
Informação obrigatória para todas as APIs.
|
|
projectApiId
|
opcional
string |
Caso tenha um projeto na Next ou deseja maior limite, esta informação poderá ser usada.
|
Endpoint: Método POST
convert_currency
Parâmetros de requisição:
|
Parâmetro
|
Detalhes
|
Descrição
|
|---|---|---|
|
set
|
requerido
string |
Informação sobre a moeda que deseja consultar a partir de uma moeda referencial.
Exemplo: eur-brl — Conversão de Real Brasileiro para Dólar Americano |
|
date
|
opcional
string |
Retorna a cotação final de uma data especifica com até 30 dias antes da data atual.
Formato: 20240704 — (AAAAMMDD – AnoMêsDia) |
Exemplo
curl -X POST "https://tools.nextexperience.com.br/api/convert_currency" \ -H "appId: seu_app_id" \ -d "set=eur-brl"
Resposta:
{ “name”: “Euro/Real Brasileiro”, “buy”: “5.9224”, “sell”: “5.9304”, “varBuy”: “-0.0787”, “pctChange”: “-1.31”, “high”: “6.1083”, “low”: “5.9023”, “date”: “2024-07-04 14:45:03”, “ref”: “5fVNcaFBr26mmz9bGHBeR5pC8YwdqYHO10mQ3ZgZ2c3NKPMlwO” }
Definição:
- name: Nome da Conversão
- buy: Valor final de compra
- sell: Valor final de venda
- varBuy: Variação do valor de compra
- pctChange: Variação geral
- high: Maior valor do dia
- low: Menor valor do dia
- date: data da cotação
- ref: referência do pacote de moedas usado na conversão
Consulta Múltipla
A API aceita que seja enviado mais de uma cotação em uma mesma consulta, alterando um pouco a forma da resposta, exemplo:
curl -X POST "https://tools.nextexperience.com.br/api/convert_currency" \ -H "appId: seu_app_id" \ -H "projectApiId: seu_project_api_id" \ -d "set=eur-brl,usd-brl"
Resposta:
{ “EURBRL”: { “name”: “Euro/Real Brasileiro”, “buy”: “5.9199”, “sell”: “5.9279”, “varBuy”: “-0.0812”, “pctChange”: “-1.35”, “high”: “6.1083”, “low”: “5.9023” }, “USDBRL”: { “name”: “Dólar Americano/Real Brasileiro”, “buy”: “5.4805”, “sell”: “5.4812”, “varBuy”: “-0.0755”, “pctChange”: “-1.36”, “high”: “5.5595”, “low”: “5.466” }, “info”: { “date”: “2024-07-04 14:55:03”, “ref”: “RYWLNYjdZyJTH01Kz06TQgrtK8USF8uhUAqaZddWjyVrxiiHfF” } }
Tratamento de Erros
Todas as respostas de erro retornam em JSON explicito, exemplo:
{ “status”: 404, “code”: “GroupCoinNotFound”, “message”: “Currency group no found” }