Obtener los clientes y suscriptores a través de la API

Se introduce el nuevo recurso contacts en la API, que unifica en una sola entidad tanto clientes como suscriptores. Esto permite trabajar con los datos de los clientes de forma independiente a los pedidos y acceder también a los suscriptores.

Nuevo endpoint: Get contact detail

Nuevo endpoint para obtener un contacto concreto: GET /api/v1/contacts/{id}.

Permite recuperar toda la información asociada, incluyendo datos personales, estado de registro, estado de suscripción a comunicaciones, etc.

Este endpoint refleja el modelo unificado, donde un contacto puede existir por distintos motivos (pedido, registro, suscripción o importación) y puede estar registrado o no. Un contacto puede ser cliente, suscriptor o ambos.

Nuevo endpoint: List contacts

Nuevo endpoint para obtener listados de contactos:

GET /api/v1/contacts?view=customers ``GET /api/v1/contacts?view=subscribers

El parámetro view es obligatorio y permite definir el subconjunto de contactos a recuperar (clientes o suscriptores).

Permite consultar clientes y suscriptores de forma independiente a los pedidos, con soporte de filtros avanzados y ordenación. Entre otros, es posible filtrar por email, estado de registro, tipo de cliente (B2B), estado de suscripción a comunicaciones o fechas de creación y último acceso.

👌 Más detalles en el blog técnico

Consulta el blog de opentiendas.dev para ver el detalle completo del recurso customers, ejemplos de filtros y estructura de datos. Última versión de la API 1.2.6.