Novedades

El endpoint de novedades devuelve los instrumentos que registraron alguna novedad a partir de una fecha indicada. Permite distinguir altas, bajas y modificaciones mediante el segmento de operación en la URL, y aplicar consultas OData para filtrar el resultado. La estructura de la respuesta es la misma que la del endpoint data/by-odata.

URL

Devuelve los instrumentos que tuvieron novedades de tipo alta, baja o modificación desde la fecha indicada, soportando filtros OData adicionales.

GET https://apids.primary.com.ar/prd-ro/v3/api/Schemas/schema-010/News/{operation}

Headers

Headers necesarios para invocar el servicio.

Header	Valor	Estado	Descripción
Ocp-Apim-Subscription-Key	<API_KEY>	Requerido	API Key habilitada para consumir Primary Reference.
Content-Type	application/json	Requerido	Header recomendado para las requests de ejemplo.

Parámetros

Parámetros esperados por la URL para ejecutar la consulta.

Nombre	Ubicación	Tipo	Estado	Descripción
operation	path	string	Requerido	Tipo de novedad a consultar. Valores admitidos: inserts (altas), updates (modificaciones) y deletes (bajas).
dateFrom	query	string	Requerido	Fecha desde la que se consultan las novedades. Acepta formato YYYY-MM-DD; opcionalmente puede incluir hora en formato YYYY-MM-DDTHH:mm:ss.
filter	query	string	Opcional	Expresión OData para filtrar las novedades, por ejemplo type eq 'CS' o type ne 'OPT'.
$skip	query	number	Opcional	Cantidad de registros a omitir desde el inicio del listado.
$top	query	number	Opcional	Cantidad máxima de registros a devolver.

Probar endpoint

Probar novedades

Ingrese una API Key, la operación y la fecha desde para consultar novedades.

API Key

La API Key se usa sólo para esta prueba y no se persiste en cookies.

Operación

Tipo de novedad: inserts, updates o deletes. Requerido.

dateFrom

Fecha desde la que se consultan las novedades. Acepta YYYY-MM-DD u opcionalmente YYYY-MM-DDTHH:mm:ss. Requerido.

filter

Expresión OData opcional para filtrar las novedades por tipo u otros atributos. Opcional.

$skip

Cantidad de registros a omitir. Opcional.

$top

Cantidad máxima de registros a devolver. Opcional.

Request preview

GET https://apids.primary.com.ar/prd-ro/v3/api/Schemas/schema-010/News/{operation}

Ocp-Apim-Subscription-Key: ********

Campos de respuesta

Campos de primer nivel

Campo	Tipo	Descripción
`data`	`array<object>`	Instrumentos con la novedad informada para la operación consultada.
`totalCount`	`number`	Cantidad total de registros que satisfacen los filtros aplicados.

Estructura de `data[]`

Campo	Tipo	Descripción
`name`	`string`	Identificador del instrumento.
`type`	`string`	Tipo de instrumento, por ejemplo `CS`, `CD`, `OPT`.
`active`	`boolean`	Indica si el instrumento se encuentra activo.
`fields`	`object`	Atributos del instrumento al momento de la novedad.
`updated`	`string`	Fecha y hora de la novedad, en formato ISO 8601.

Campos de `fields`

Los campos que viajan dentro de fields dependen del tipo de instrumento. Consulte el diccionario de campos para ver, por cada tipo, los campos que publica con su nombre de negocio.

Los valores admitidos para operation son inserts (altas), updates (modificaciones) y deletes (bajas). El parámetro dateFrom define el límite inferior temporal de la consulta.

URL