Saltar al contenido principal

Seleccionar formato

Usa ?format=json|csv|xml o la cabecera Accept (application/json, text/csv, application/xml, text/xml). El query tiene prioridad. Sin una selección explícita, JSON es el formato por defecto; no uses el Accept de un navegador para elegir formatos automáticamente.

Acceso por plan

CSV y XML requieren Esencial o superior. JSON está disponible en todos los planes, sujeto al acceso al endpoint y al mercado. Elegir JSON no elimina el consumo normal de cuota.

Estructura CSV

CSV usa coma como separador y punto decimal. Los objetos se aplanan con nombres como from.currency. Si existe una colección de objetos, cada elemento forma una fila y los demás campos se repiten; las columnas de la colección llevan prefijo, como rates.mid. Las columnas incluyen la unión de campos presentes y pueden crecer. Varias colecciones de objetos no caben en una tabla única: pueden producir 406 format_not_available. Para /route usa JSON o XML. En hojas de cálculo selecciona explícitamente delimitador y formato numérico al importar.

Estructura XML

La raíz es <response>. Cada clave se representa como un elemento y los elementos de arrays se llaman <item>. Un campo nulo es un elemento vacío; un campo ausente se omite. Fragmento ilustrativo:

Comprobar el estado antes de interpretar

Los errores producidos por la API siguen siendo JSON aunque pidas CSV/XML; un proxy puede responder otro formato. 400 invalid_format indica formato desconocido, 402 feature_not_in_plan falta de acceso y 406 format_not_available una representación incompatible. Los clientes JSON del inicio rápido son para JSON; no les pases format=csv o xml.

Cobertura

Esta selección se aplica a las rutas autenticadas con API Key descritas aquí. No habilita una utilidad desactivada, no convierte monedas y no cambia el idioma de los identificadores ni los nombres procedentes de la fuente.