Actualiza el estado de lectura y borra los indicadores de mensajes no leídos en las sesiones de chat de órdenes peer-to-peer (C2C/P2P) para el usuario y orden especificados.
/sapi/v1/c2c/chat/markOrderMessagesAsReadEste endpoint permite a aplicaciones cliente, paneles de control para comerciantes y bots de trading automatizados confirmar la recepción y lectura de mensajes entrantes dentro de una orden C2C (P2P) activa o finalizada. Al proporcionar el número de orden (orderNo) y el identificador de usuario de la cuenta objetivo (userId), las aplicaciones limpian el distintivo de notificaciones pendientes y actualizan las confirmaciones de lectura para la contraparte.
Integrar esta llamada dentro de flujos de trabajo de notificación asegura que las consolas de atención al cliente y mesas de ayuda mantengan contadores sincronizados de mensajes no leídos en terminales web, de escritorio y móviles.
01
Parámetros aceptados en el cuerpo (Body) y encabezados HTTP.
| Parámetro | Ubicación | Tipo | Requerido | Descripción |
|---|---|---|---|---|
clientType | Header | STRING | Requerido | Tipo de dispositivo o cliente que realiza la petición (por ejemplo, WEB, APP o WEB_MOBILE). |
orderNo | Body | STRING | Requerido | Identificador único de la orden C2C vinculado al hilo de conversación del chat. |
userId | Body | INT64 | Opcional | Identificador de usuario de la cuenta objetivo que marca la conversación como leída. |
x-gray-env | Header | STRING | Opcional | Identificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing). |
x-trace-id | Header | STRING | Opcional | Identificador de trazabilidad generado por el cliente para el seguimiento y depuración de la solicitud. |
x-user-id | Header | STRING | Opcional | Identificador de usuario objetivo si se requiere evaluar el contexto de la cuenta. |
Sincronización de Notificaciones en la Interfaz
Ejecuta este endpoint de forma automática tan pronto como el operador o bot obtenga nuevos mensajes a través de WebSockets o endpoints de sondeo (polling), manteniendo precisas las bandejas de entrada de soporte.
02
Ejemplo de solicitud POST mediante cURL para marcar los mensajes de una orden como leídos.
curl -X POST \
'https://api.binance.com/sapi/v1/c2c/chat/markOrderMessagesAsRead' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
"orderNo": "202608171234567890",
"userId": 123456789
}'03
Ejemplo de respuesta devuelta tras la actualización exitosa del estado de lectura.
{
"code": "000000",
"message": "success",
"data": null,
"success": true
}| Campo | Tipo | Descripción |
|---|---|---|
code | STRING | Código de respuesta estándar de Binance ("000000" indica éxito). |
message | STRING | Mensaje descriptivo del resultado o confirmación de la petición. |
data | NULL / VOID | Carga útil vacía devuelta tras confirmar con éxito la lectura de los mensajes. |
success | BOOLEAN | Indica el resultado general de la ejecución de la petición. |
04
Flujo de trabajo para sincronizar el estado de lectura en el chat de órdenes C2C.
Sincronización de Contadores de Notificaciones
Limpia los avisos pendientes en la interfaz automáticamente cuando un operador abre la ventana de la orden en el software comercial.
Confirmación Automática en Bots de Chat
Permite a bots de mensajería marcar consultas como leídas tras procesar palabras clave o generar respuestas predeterminadas.
Consolas de Soporte Multiagente
Evita respuestas duplicadas entre operadores al reflejar con precisión el estado de lectura en tiempo real para todo el equipo.