GET
/jacaerys/v1/forwards/origin-owners/141518Consultar propietarios de un origen de reenvío
Lista los propietarios que tienen procesos de reenvío activos en un origen, para identificar colisiones de palabras clave.
API de Mensajería
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
Descripción
Este endpoint devuelve la lista de propietarios identificados para un origen y la cantidad de procesos de reenvío que cada uno tiene activos en ese origen. Permite detectar colisiones potenciales cuando varios propietarios gestionan palabras clave distintas sobre el mismo origen.
Los parámetros de consulta clientId y externalId son opcionales, pero se recomiendan para segmentar la búsqueda cuando se gestionan grandes volúmenes de cuentas bajo un mismo integrador.
Respuesta exitosa (200 OK)
Objeto `owners`
Lista de propietarios identificados. Cada objeto contiene:
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| ownerId | string | Sí | Identificador único del propietario. |
| name | string | Sí | Nombre o descripción del propietario. |
| processesCount | integer | Sí | Cantidad de procesos de reenvío que este propietario tiene activos en el origen. |
| clientId | string | Sí | ID del cliente asociado. |
Objeto `meta`
Información de paginación.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| totalItems | integer | Sí | Total de propietarios encontrados. |
| itemCount | integer | Sí | Número de propietarios en la respuesta actual. |
| itemsPerPage | integer | Sí | Límite de registros por página. |
| totalPages | integer | Sí | Total de páginas disponibles. |
| currentPage | integer | Sí | Página actual. |
Errores
| Código | Descripción |
|---|---|
| 400 Bad Request | La solicitud es inválida. Puede deberse a un formato de origen no soportado o a parámetros de consulta incorrectos. |
| 401 Unauthorized | Error de autenticación. El token proporcionado es inválido, ha expirado o no tiene acceso a la API Jacaerys. |
| 403 Forbidden | El usuario no tiene permisos suficientes para consultar la propiedad de este origen. |
| 404 Not Found | No se encontró el origen especificado o no tiene propietarios con procesos asignados. |
| 500 Internal Server Error | Ocurrió un error inesperado en el servidor durante la recuperación de datos. |
Notas técnicas y advertencias
- Propiedad compartida: en entornos corporativos, un mismo origen puede tener múltiples propietarios (departamentos, sucursales, clientes) que gestionan palabras clave distintas. Este endpoint ayuda a identificar colisiones potenciales.
- Fidelidad textual sobre codificación: aunque este endpoint consulta metadatos de configuración, la lógica de negocio subyacente de los propietarios está ligada a mensajes entrantes que pueden llegar en GSM-7 o Unicode, según la red del operador.
- Uso de filtros:
clientIdyexternalIdson opcionales, pero se recomiendan para segmentar la búsqueda con grandes volúmenes de cuentas bajo un mismo integrador.
Ejemplo de solicitud
curl --request GET \
--url 'https://api.getincloud.online/jacaerys/v1/forwards/origin-owners/141518?limit=10' \
--header 'accept: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN'Ejemplo de respuesta (200 OK)
{
"owners": [
{
"ownerId": "user_admin_01",
"name": "Departamento de Marketing",
"processesCount": 5,
"clientId": "client_9988"
},
{
"ownerId": "user_dev_02",
"name": "Equipo de Desarrollo - Webhooks",
"processesCount": 2,
"clientId": "client_9988"
}
],
"meta": {
"totalItems": 2,
"itemCount": 2,
"itemsPerPage": 10,
"totalPages": 1,
"currentPage": 1
}
}¿Te sirvió esta página?