Primeiros passos
Taxas de câmbio ao vivo
O endpoint
live fornece acesso instantâneo às taxas de câmbio atuais em várias moedas, permitindo cálculos financeiros em tempo real e monitorização de mercado.Conversão de moeda
O endpoint
convert converte montantes específicos entre moedas utilizando as taxas de câmbio mais atualizadas — perfeito para aplicações financeiras e plataformas de e-commerce.Símbolos de moeda disponíveis
O endpoint
symbols fornece um catálogo abrangente de moedas suportadas com descrições detalhadas, facilitando a seleção dinâmica de moeda e validação em aplicações.Arquitetura REST
A API de taxas de câmbio segue os princípios REST, utilizando URLs previsíveis e orientadas a recursos e códigos de estado HTTP padrão para integração fluida e tratamento de erros.Segurança HTTPS
Todas as comunicações da API são protegidas com protocolos de encriptação TLS 1.2 ou superior para garantir a integridade e privacidade dos dados.Versionamento da API
A API de taxas de câmbio mantém compatibilidade retroativa através de versionamento, operando atualmente na Versão 1 com melhorias futuras planeadas.Autenticação
A sua chave API serve como credencial exclusiva para aceder à API de taxas de câmbio. Cada serviço Cleariflow requer uma chave única, garantindo acesso seguro e isolado entre diferentes APIs.Códigos de resposta e erro
Quando os pedidos falham, a API devolve respostas de erro JSON estruturadas com códigos e descrições específicos para resolução eficaz de problemas.| Code | Type | Detalhes |
|---|---|---|
| 200 | OK | Tudo funcionou como esperado. |
| 204 | OK | Não existem dados de localização para o IP enviado. |
| 400 | Bad request | Pedido inválido. |
| 401 | Unauthorized | O pedido não foi aceite — normalmente devido a uma chave API em falta ou incorreta. |
| 422 | Quota reached | O pedido foi abortado devido a créditos API insuficientes (planos gratuitos). |
| 429 | Too many requests | O pedido foi abortado porque foi atingido o número de pedidos permitidos por segundo. Isto acontece em planos gratuitos, pois os pedidos estão limitados a 1 por segundo. |
| 500 | Internal server error | O pedido não pôde ser concluído devido a um erro no servidor. |
| 503 | Service unavailable | O servidor estava indisponível. |