API de plataforma digital: servicio de moneda

Artículo
05/18/2024

Advertencia

El servicio de moneda de API está disponible para los clientes únicamente para conciliar los importes pagados o recibidos por ellos resultantes de sus transacciones a través de la Plataforma Xandr y no pueden ser utilizados por los clientes para ningún otro propósito.

Se trata de un servicio de solo lectura que muestra la lista de monedas que puede establecer para usar un elemento de línea o un orden de inserción.

API de REST

Http (método)	Endpoint	Description
`GET`	`https://api.appnexus.com/currency`	Ver todas las monedas disponibles
`GET`	`https://api.appnexus.com/currency?code=CURRENCY_CODE`	Visualización de una moneda específica
`GET`	`https://api.appnexus.com/currency?code=CURRENCY_CODE&show_rate=true`	Ver el tipo de cambio de una moneda para hoy
`GET`	`https://api.appnexus.com/currency?show_rate=true&code=CURRENCY_CODE&ymd=2012-03-01`	Ver el tipo de cambio de una moneda durante un día en el pasado

Nota:

Las tasas de cambio se obtienen una vez al día desde Oanda aproximadamente a las 3:00 a.m. UTC.

Campos JSON

Fields	Tipo	Descripción
`as_of`	string	Fecha y hora en que Oanda actualizó por última vez el tipo de cambio en UTC. Extraemos las tarifas de Oanda todos los días a las 3:00 a.m. UTC. Esto solo se devuelve cuando se pasa `show_rate=true` la cadena de consulta.
`code`	string	Código de la moneda.
`description`	string	Descripción de la moneda.
`is_exposed`	booleano	Si `true`es , se expone la moneda.
`last_modified`	string	Fecha y hora en que se modificó la moneda por última vez. (Ver nota *)
`name`	string	Nombre completo de la moneda.
`position`	enumeración	Si el símbolo de moneda aparece antes o después del importe. Valores posibles: `"before"` o `"after"`.
`rate_per_usd`	double	Tipo de cambio. Esto solo se devuelve cuando se pasa `show_rate=true` la cadena de consulta.
`symbol`	string	Símbolo de la moneda, por ejemplo `"$"` , para USD

Nota:

Para mostrar las tasas de conversión, pase show_rate=true la dirección URL. También puede recuperar la tasa de un día pasado pasando ymd=YYYYMMDD a través de la dirección URL.
* Al consultar la API de moneda (por ejemplo, rate_per_usd), el servicio devuelve todos los valores correctos, con la excepción de last_modified. Las tasas reales son precisas y la API devuelve los tipos de cambio actualizados.

Use la as_of columna en lugar de last_modified para conocer la versión del tipo de cambio que se devuelve.

Ejemplos

Ver todas las monedas disponibles

curl -b cookies -c cookies 'https://api.appnexus.com/currency'
{
    "response": {
        "status": "OK",
        "currencies": [
            {
                "code": "ARS",
                "symbol": "₱",
                "name": "Argentine Peso (ARS)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-16 23:07:23",
                "is_exposed": true
            },
            {
                "code": "AUD",
                "symbol": "AUD$",
                "name": "Australian Dollar (AUD)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-24 19:29:04",
                "is_exposed": true
            },
            {
                "code": "BRL",
                "symbol": "R$",
                "name": "Brazilian Real (BRL)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-16 23:07:23",
                "is_exposed": true
            },
            {
                "code": "CAD",
                "symbol": "CDN$",
                "name": "Canadian Dollar (CAD)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-24 19:29:04",
                "is_exposed": true
            },
            {
                "code": "CNY",
                "symbol": "元",
                "name": "Chinese Yuan (CNY)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-16 23:07:23",
                "is_exposed": true
            },
                        ...
        ],
        "count": 17,
        "start_element": null,
        "num_elements": null
    }
}

Ver el tipo de cambio eur el 2 de enero de 2024

$ curl -b cookies -c cookies  'https://api.appnexus.com/currency?show_rate=true&code=EUR&ymd=2012-03-01'
{
    "response": {
        "status": "OK",
        "currency": {
            "code": "EUR",
            "symbol": "€",
            "name": "Euro (EUR)",
            "description": null,
            "position": "before",
            "last_modified": "2010-08-16 23:07:23",
            "rate_per_usd": 0.7506,
            "as_of": "2024-01-02 11:24:00",
            "is_exposed": true
        },
        "count": 1,
        "start_element": null,
        "num_elements": null
    }
}

Compartir a través de