Listar relaciones de objetos

Utiliza este endpoint para listar los objetos de datos relacionados a partir de un objeto de anclaje.

Importante

Los objetos de datos están disponibles de forma general, pero tu espacio de trabajo debe estar aprovisionado para Cuentas antes de que puedas usar este endpoint. Para solicitar el aprovisionamiento, ve a Configuración de datos > Cuentas y completa el cuestionario. Para más detalles, consulta Habilitar Cuentas.

Requisitos previos

Para utilizar este endpoint, necesitas una clave de API con el permiso data_objects.read.

Límite de velocidad

Este endpoint se encuentra en el contenedor de lectura de objetos de datos, con un límite predeterminado de 1000 solicitudes por minuto.

Parámetros de ruta

La siguiente tabla enumera y describe los parámetros de ruta del endpoint /data_objects/objects/{type_name}/{object_id}/object_relationships.

Parámetros de consulta

La siguiente tabla enumera y describe los parámetros de consulta del endpoint /data_objects/objects/{type_name}/{object_id}/object_relationships.

Solicitud de ejemplo

Esta sección incluye una carga útil de parámetros de ejemplo y una solicitud cURL de ejemplo.

Carga útil de solicitud de ejemplo

Utiliza este objeto JSON como referencia para los parámetros de solicitud.

1
2
3
4
5
6
7
8

{
  "type_name": "account",
  "object_id": "acct-123",
  "anchor": "source",
  "rel_kind": "subaccount",
  "limit": 100,
  "offset": 0
}

Solicitud cURL de ejemplo

Este ejemplo lista los registros subaccount a los que enlaza acct-123 y devuelve la primera página de resultados.

1
2

curl --location --request GET 'https://rest.iad-01.braze.com/data_objects/objects/account/acct-123/object_relationships?anchor=source&rel_kind=subaccount&limit=100&offset=0' \
--header 'Authorization: Bearer YOUR_REST_API_KEY'

Respuesta

Esta sección incluye una respuesta correcta de ejemplo y los campos de la respuesta.

Ejemplo de respuesta correcta

El código de estado 200 podría devolver el siguiente cuerpo de respuesta.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

{
  "items": [
    {
      "rel_kind": "subaccount",
      "to_data_object": {
        "type_name": "account",
        "object_id": "acct-456",
        "attributes": { "name": "Child Account" }
      },
      "attributes": {}
    }
  ],
  "total_count": 1,
  "has_more": false,
  "next_offset": null,
  "offset": 0,
  "limit": 100
}

Con anchor=target, los objetos relacionados se devuelven como from_data_object.

Parámetros de respuesta

La siguiente tabla enumera y describe los campos de una respuesta correcta.

Errores

La siguiente tabla enumera los errores comunes de este endpoint y cómo resolverlos.