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
- En la barra lateral izquierda, haz clic en Fuentes de Datosy, a continuación, Nueva fuente de datos.
- En API, selecciona API y haz clic en Continuar.
- Elige Enviar datos a Sendtric y haz clic en Continuar.
- 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_idoemail. Cada registro que envíes debe incluirlo. - Descripción (opcional).
- 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.
- Copia lo que necesites y luego haz clic en Continuar para terminar.

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/jsonLa 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_KEYElimina 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ímite | Valor |
|---|---|
| Registros por solicitud | 10 000 |
| Tamaño de la solicitud | 10 MB |
| Valor del identificador | 255 caracteres |
| Cualquier valor de texto | 10 KB |
| Profundidad de anidación | 20 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
| Estado | Qué significa | Qué hacer |
|---|---|---|
| 200 | Se aceptan registros | Nada. Si se han saltado algunas pistas, el encabezado «X-Skipped-Records» indica cuántas |
| 400 | El cuerpo no es JSON válido | Comprueba el cuerpo de la solicitud |
| 401 | Falta la clave API o es incorrecta | Comprueba el encabezado «Authorization» |
| 404 | No se ha encontrado la fuente de datos para esta clave | Comprueba el punto final y que la clave pertenezca a la misma cuenta |
| 413 | Demasiados registros o demasiado grandes | Divide la solicitud en lotes más pequeños |
| 422 | No se ha podido guardar el registro | El mensaje indica qué registros carecen del campo de identificador o son demasiado grandes |
| 503 | Sendtric está ocupado | Espera 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
- Cómo usar una fuente de datos en una imagen personalizada
- Cómo usar una fuente de datos en una imagen basada en reglas
- Cómo gestionar, editar y eliminar una fuente de datos
¿Te ha sido útil este artículo?
¡Gracias por tu comentario!
