GET
https://api.getincloud.online/jacaerys/v1/forwards/origin-owners/{origin}Listar propietarios de origen (List Origin Owners)
Lista los propietarios (usuarios o entidades) con procesos de reenvío configurados en un origen.
API de Mensajería
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
Este endpoint recupera todos los propietarios (usuarios o entidades) que tienen procesos de reenvío configurados para un origen específico (shortcode, longcode o ID alfanumérico). Es fundamental para la gestión de permisos y la auditoría de quién usa un recurso de entrada compartido.
GET https://api.getincloud.online/jacaerys/v1/forwards/origin-owners/{origin}Parámetros de ruta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| origin | string | Sí | Código corto, número largo o identificador alfanumérico del cual se desean consultar los propietarios. |
Parámetros de consulta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| clientId | string | No | Filtra los propietarios asociados a un identificador de cliente específico. |
| externalId | string | No | Filtra los resultados según un identificador de sistema externo vinculado a la propiedad del origen. |
| page | integer | No | Número de página para la paginación. |
| limit | integer | No | Número de registros devueltos por página. |
Encabezados
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Authorization | string | Sí | Token de portador (Bearer token). Formato: Bearer <TU_TOKEN>. |
| accept | string | No | application/json. |
Respuestas
200 OK
| Campo | Tipo | Descripción |
|---|---|---|
| owners | array de objetos | Lista de propietarios identificados. |
| owners[].ownerId | string | Identificador único del propietario. |
| owners[].name | string | Nombre o descripción del propietario. |
| owners[].processesCount | integer | Cantidad de procesos de reenvío que este propietario tiene activos en el origen. |
| owners[].clientId | string | ID del cliente asociado. |
| meta | objeto | Información de paginación. |
| meta.totalItems | integer | Total de propietarios encontrados. |
| meta.itemCount | integer | Número de propietarios en la respuesta actual. |
| meta.itemsPerPage | integer | Límite de registros por página. |
| meta.totalPages | integer | Total de páginas disponibles. |
| meta.currentPage | integer | Página actual. |
Errores
| Código | Descripción |
|---|---|
| 400 Bad Request | Formato de origen no soportado o parámetros de consulta incorrectos. |
| 401 Unauthorized | El token 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 o no tiene propietarios con procesos asignados. |
| 500 Internal Server Error | 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 varios propietarios (departamentos, sucursales, clientes) que gestionan palabras clave distintas. Este endpoint ayuda a identificar colisiones potenciales.
- Codificación: aunque este endpoint consulta metadatos de configuración, la lógica de negocio 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 al gestionar 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'Respuesta de ejemplo (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?