Fuentes de Datos y API

Cómo enviar registros a una fuente de datos con la API de Sendtric

Última actualización

Con una fuente de datos API, tu propio sistema envía registros JSON a Sendtric cada vez que cambian tus datos. Sendtric los almacena como datos alojados, y tus imágenes consultan el registro de cada suscriptor cuando se abre un correo electrónico.

Esta guía va dirigida a quien escriba el código que envía los datos. Si prefieres que Sendtric recupere los datos de tu API cada vez que se abra el correo, consulta cómo conectar una fuente de datos a tu propia API.

Crea la fuente de datos

  1. En la barra lateral izquierda, haz clic en Fuentes de Datosy, a continuación, Nueva fuente de datos.
  2. En API, selecciona API y haz clic en Continuar.
  3. Elige Enviar datos a Sendtric y haz clic en Continuar.
  4. Rellena:
    • Nombre de la fuente de datos: por ejemplo, «Miembros del programa de fidelidad».
    • Campo de identificador único: el campo JSON que identifica cada registro, como customer_id o email. Cada registro que envíes debe incluirlo.
    • Descripción (opcional).
  5. Haz clic en Guardar fuente de datos. Se crea la fuente de datos y la paso de la API muestra tus puntos de conexión y tu clave de API.
  6. Copia lo que necesites y luego haz clic en Continuar para terminar.
La sección de la API de una nueva fuente de datos, donde se muestran los puntos finales para la inserción y actualización de un solo registro y en bloque, la clave de la API y ejemplos de solicitudes

Puedes volver a encontrar los puntos finales en cualquier momento en las Fuentes de Datos pestaña «Detalles de la API» .

Iniciar sesión

Envía tu clave en el Authorization encabezado de cada solicitud:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

La Clave de la API de las Fuentes de Datos solo sirve para enviar registros de Fuentes de Datos, así que puedes dársela sin problema a un desarrollador o a una herramienta de automatización. Si tienes un plan de API, tu clave actual del plan de API también funciona en estos puntos de conexión.

No incluyas tu clave en el código front-end ni en repositorios públicos. Si alguna vez se filtra, vuelve a generarla en Ajustes → Claves de API → Clave API de fuentes de datosy, a continuación, actualiza todo lo que la utilice.

Crear o actualizar registros

ENVÍA un único objeto JSON, o una lista de objetos, al punto final que aparece en Sendtric. Un registro:

POST <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "customer_id": "CUST_1001",
  "first_name": "Sarah",
  "points": 1250
}

Varios registros en una sola solicitud:

POST <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[
  { "customer_id": "CUST_1001", "first_name": "Sarah", "points": 1250 },
  { "customer_id": "CUST_1002", "first_name": "James", "points": 300 }
]

Cómo se guardan los registros:

  • Si todavía no hay ningún registro con ese identificador, se crea uno nuevo.
  • Si lo haces, es se sustituye por lo que hayas enviado. Los campos que no incluyas se eliminarán, así que envía siempre el registro completo.
  • Los registros nuevos y actualizados suelen estar disponibles en aproximadamente un minuto.
  • Los identificadores se comparan sin tener en cuenta si son mayúsculas o minúsculas.

Una solicitud que se ha realizado correctamente devuelve 200 un breve resumen, por ejemplo {"status":"ok","records":2}.

Puedes anidar objetos dentro de un registro, por ejemplo "address": { "city": "Leeds" }, y seleccionar campos anidados en el editor de imágenes.

Eliminar registros

Para borrar un registro, añade su identificador al final del endpoint:

DELETE <your data source endpoint>/cust_1001
Authorization: Bearer YOUR_API_KEY

Elimina varios enviando una lista de identificadores:

DELETE <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

["cust_1001", "cust_1002"]

Límites

LímiteValor
Registros por solicitud10 000
Tamaño de la solicitud10 MB
Valor del identificador255 caracteres
Cualquier valor de texto10 KB
Profundidad de anidación20 niveles

Envía los registros por lotes en lugar de hacer una solicitud por cada registro. Si tienes miles de registros, mira cómo enviar grandes cantidades de datos a una fuente de datos.

Respuestas y errores

EstadoQué significaQué hacer
200Se aceptan registrosNada. Si se han saltado algunas pistas, el encabezado «X-Skipped-Records» indica cuántas
400El cuerpo no es JSON válidoComprueba el cuerpo de la solicitud
401Falta la clave API o es incorrectaComprueba el encabezado «Authorization»
404No se ha encontrado la fuente de datos para esta claveComprueba el punto final y que la clave pertenezca a la misma cuenta
413Demasiados registros o demasiado grandesDivide la solicitud en lotes más pequeños
422No se ha podido guardar el registroEl mensaje indica qué registros carecen del campo de identificador o son demasiado grandes
503Sendtric está ocupadoEspera el número de segundos que indica el encabezado «Retry-After» y, después, vuelve a enviar la misma solicitud

Cuando solo algunos registros de una solicitud no son válidos, los que sí lo son se guardan de todos modos y el resto se omiten.

Revisa tus registros

Abre la fuente de datos y ve a la pestaña «Registros» . Busca por el valor del identificador y haz clic en un registro para ver el JSON completo que Sendtric tiene guardado.

Siguiente paso

¿Te ha sido útil este artículo?

Haz clic en la imagen para ampliarla. Arrastra o desplázate para moverte.