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”
}