Ir al contenido

Esta página fue traducida automáticamente y puede contener errores. Para informar de un error de traducción, usa el componente de comentarios situado bajo el sumario, a la derecha de la página.

Crear objeto de datos

post

/data_objects/objects/{type_name}

Utiliza este endpoint para crear un objeto de datos para un tipo.

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 utilizar 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.create.

Límite de velocidad

Este endpoint se encuentra en el contenedor de escritura 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 para el endpoint /data_objects/objects/{type_name}.

Parámetro	Obligatorio	Tipo de datos	Descripción
`type_name`	Obligatorio	Cadena	Nombre de máquina del tipo de objeto de datos

Parámetros de solicitud

La siguiente tabla enumera y describe los parámetros del cuerpo de la solicitud JSON para el endpoint /data_objects/objects/{type_name}.

Parámetro	Obligatorio	Tipo de datos	Descripción
`object_id`	Obligatorio	Cadena	Identificador del objeto, único dentro del tipo. Solo puede incluir letras, números, guiones y guiones bajos, y debe tener 250 caracteres o menos
`attributes`	Obligatorio	Objeto	Valores indexados por nombre de campo que se validan con el esquema del tipo
`display_name`	Opcional	Cadena	Etiqueta de visualización del objeto. Cuando el tipo tiene un campo de origen para el nombre de visualización, el valor de ese campo tiene prioridad. El valor predeterminado es `object_id`

Ejemplo de solicitud

Esta sección incluye una carga útil JSON de ejemplo y una solicitud cURL de ejemplo.

Carga útil de solicitud de ejemplo

{
  "object_id": "acct-new",
  "attributes": {
    "name": "New Account",
    "industry": "software"
  }
}

Solicitud cURL de ejemplo

Este ejemplo crea un registro account con el identificador acct-new y establece sus atributos name e industry.

curl --location --request POST 'https://rest.iad-01.braze.com/data_objects/objects/account' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "object_id": "acct-new",
  "attributes": {
    "name": "New Account",
    "industry": "software"
  }
}'

Respuesta

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

Ejemplo de respuesta correcta

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

{
  "data_object": {
    "type_name": "account",
    "object_id": "acct-new",
    "attributes": { "name": "New Account", "industry": "software" }
  }
}

Parámetros de respuesta

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

Parámetro	Obligatorio	Tipo de datos	Descripción
`data_object`	Obligatorio	Objeto	Registro del objeto de datos creado
`data_object.type_name`	Obligatorio	Cadena	Nombre de máquina del tipo de objeto de datos
`data_object.object_id`	Obligatorio	Cadena	Identificador del objeto de datos
`data_object.attributes`	Obligatorio	Objeto	Atributos almacenados del objeto, indexados por nombre de campo

Errores

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

Estado	Causa	Solución
`400`	Campo de atributo desconocido o tipo de atributo no válido	Confirma que cada campo de `attributes` existe en el esquema del tipo y utiliza el tipo de datos correcto.
`404`	Tipo no encontrado (`data-object-type-not-found`)	Confirma que `type_name` existe en el espacio de trabajo y coincide exactamente con el nombre de máquina.
`409`	Objeto duplicado (`duplicate-data-object`)	Utiliza un `object_id` diferente o utiliza `PUT` para reemplazar el objeto existente.
`422`	Límite de registros alcanzado (`data-object-record-limit-exceeded`)	Reduce el número de objetos del tipo o contacta con el soporte de Braze para consultar los límites de tu espacio de trabajo.
`401`	Clave de API REST faltante o no válida	Verifica que el encabezado `Authorization` utilice `Bearer YOUR_REST_API_KEY` y que la clave esté activa.
`403`	La clave de API no tiene permisos o la lista de permitidos bloquea la solicitud	Confirma que la clave tiene el permiso `data_objects.create` y que tu IP de origen está en la lista de permitidos de la clave, si está configurada.
`429`	Límite de velocidad excedido	Vuelve a intentarlo después de `X-RateLimit-Reset` y reduce la frecuencia de las solicitudes.

New Stuff!