ovahub
Ir a la documentación
DocumentaciónReferencia de la APIConsultar mensajes
GETToken Bearer

Consultar mensajes

/api/v1/messages

Consulta los mensajes de la organización y la cantidad sin leer, con 8 mensajes por página.

Los nombres de campos, los tipos y el código de la API se mantienen iguales en todos los idiomas.

Ejemplo de petición

cURL
curl "https://tovahub.com/api/v1/messages?page=1" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

Solo ejemplos. Esta página no envía peticiones.

Respuesta ilustrativa
JSON
{
  "userId": "507f1f77bcf86cd799439013",
  "through": "2026-11-07T12:00:00.000Z",
  "messages": [],
  "unreadCount": 0,
  "page": 1,
  "pageSize": 8,
  "totalCount": 0,
  "totalPages": 1
}

Parámetros

pageConsulta · Opcional

string

Entero positivo expresado como cadena de consulta; el valor predeterminado es "1". Use totalPages para navegar.

Respuesta

Estado HTTP 200

Consulta los mensajes de la organización con paginación por número de página.

userIdstring (ObjectId)

Identificador del usuario autenticado.

throughstring (ISO 8601)

Fecha y hora de corte de la consulta que se enviará a mark_messages_read.

messagesarray

Registros de mensajes con campos seleccionados; no incluyen serverId ni dedupeKey.

messages[]._idstring (ObjectId)

Identificador del mensaje.

messages[].ticketIdstring (ObjectId) | null

Identificador del ticket de soporte asociado, si existe.

messages[].typestring

Puede ser server_expiring, server_expired, renewal_failed, balance_gift, admin_message o ticket_reply.

messages[].serverNamestring | null

Nombre del servidor asociado, si existe.

messages[].expiresAtstring (ISO 8601) | null

Vencimiento del servicio asociado, si existe.

messages[].daysLeftnumber | null

Días restantes indicados en la notificación, si existen.

messages[].amountstring | null

Importe de la notificación, si existe.

messages[].messagestring | null

Contenido del mensaje, si existe.

messages[].readAtstring (ISO 8601) | null

Fecha y hora de lectura, o null.

messages[].createdAtstring (ISO 8601)

Fecha y hora de creación del mensaje.

unreadCountnumber

Número de mensajes sin leer en toda la organización.

pagenumber

Número de página efectivo, limitado a las páginas disponibles.

pageSizenumber (8)

Tamaño fijo de página.

totalCountnumber

Número total de mensajes.

totalPagesnumber

Total de páginas; al menos una, incluso si la lista está vacía.

Relacionado

Peticiones y erroresAutenticación