Skip to main content
POST
Leer objetos en lote

Supported products

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Parámetros de consulta

archived
boolean
predeterminado:false

Si se devolverán solo los resultados que se han archivado.

Cuerpo

application/json

Especifica la entrada para leer un lote de objetos del CRM, que incluye conjuntos de ID de objetos, nombres de propiedades solicitadas (con historial opcional) y una propiedad de identificación única opcional.

inputs
object[]
requerido

Un conjunto de objetos SimplePublicObjectId, cada uno de los cuales representa un objeto que se leerá en la operación por lotes.

properties
string[]
requerido

Un conjunto de cadenas que especifican las propiedades que se devolverán para cada objeto en el lote. Si una propiedad especificada no está presente en un objeto, se ignorará.

propertiesWithHistory
string[]
requerido

Un conjunto de cadenas que especifican las propiedades que se devolverán junto con su historial de valores anteriores para cada objeto del lote. Si una propiedad especificada no está presente en un objeto, se ignorará.

idProperty
string

Una cadena que representa el nombre de una propiedad cuyos valores son únicos para el tipo de objeto. Esta propiedad se usa para identificar objetos de forma única.

Respuesta

successful operation

Un objeto de respuesta de lote de objetos públicos

completedAt
string<date-time>
requerido

La fecha y hora en que se completó la operación por lotes, en formato ISO 8601.

results
object[]
requerido

Un conjunto de elementos SimplePublicObject que representan los resultados de la operación por lotes.

startedAt
string<date-time>
requerido

La fecha y la hora en que comenzó la operación por lotes, en formato ISO 8601.

status
enum<string>
requerido

El estado actual de la operación por lotes. Los valores válidos son "PENDING", "PROCESSING", "CANCELED" y "COMPLETE".

Opciones disponibles:
CANCELED,
COMPLETE,
PENDING,
PROCESSING

Un mapa de nombres de enlaces a URI asociados para obtener información adicional relacionada con la operación por lotes.

requestedAt
string<date-time>

La fecha y la hora en que se solicitó la operación por lotes, en formato ISO 8601.

Última modificación el 6 de octubre de 2026